Paramètres Company/Classe/Enterprise - Développeur

1. Cliquez sur l'onglet Applications OAuth de la page Développeur pour afficher la liste de toutes vos applications :

   

2. Cliquez sur le bouton Créer une nouvelle application OAuth :

3. Remplissez le formulaire :

   • Nom - Nom de l'application affichée aux utilisateurs.

   • Format principal - Chaîne qui identifie de manière unique votre application et qui indique les données qu'elle peut stocker sur les serveurs Onshape (par exemple, com.exemple.exemple). Ne peut pas être modifié une fois l'application enregistrée. Non affiché aux utilisateurs.

   • Résumé - Description de l'application, présentée à l'utilisateur lorsqu'il est invité à autoriser l'application à accéder à ses données.

   • URL de redirection - URL vers laquelle vous êtes redirigé après authentification ; page de destination de votre application.

     • Votre application doit spécifier au moins une URL utilisée dans les échanges via le protocole OAuth.

     • Cette URL doit également utiliser le protocole SSL (une URL commençant par https), à l'exception de deux cas applicables aux applications de bureau installées : http://localhost:<port> et urn:ietf:wg:oauth:2.0:oob.

   • Type - Type d'application : Application cloud intégrée, Application cloud connectée, ou Application de bureau connectée.

   • URL OAuth - URL utilisée pour démarrer le processus OAuth2 afin d'authentifier l'utilisateur. Voir Documentation pour les développeurs : OAuth2 pour plus de détails.

     • Doit contenir l'URL de votre application déployée.

     • Il s'agit de la première URL appelée depuis la page Onshape Applications.

     • La page hébergée sur cette URL doit gérer l'authentification OAuth. Une fois que le serveur de votre application a été authentifié pour le compte de l'utilisateur, celui-ci doit être redirigé vers le contenu de votre application.

     • Si vous n'avez pas encore déployé votre application, vous pouvez laisser ce champ vide pour le travail local et le mettre à jour plus tard.

       Toutes les applications soumises à l'App Store Onshape pour un usage public doivent s'authentifier correctement auprès d'OAuth2. Voir Documentation pour les développeurs : OAuth2 pour plus de détails.

   • Réglages

     • Favorise la collaboration - Cochez si vous souhaitez collaborer avec d'autres utilisateurs lors du développement de l'application.

   • Autorisations - Voir Étendue des autorisations ci-dessous.

4. Cliquez sur Créer une application.

5. Copiez la clé secrète OAuth depuis la fenêtre.

   Vous ne pourrez plus accéder à cette clé secrète. Ce secret est propre à vous et à votre application. Il doit être protégé comme n'importe quel mot de passe sensible et ne jamais intégrer le code source.

6. L'entrée de l'application OAuth s'affiche avec l'onglet Détails sélectionné. Lorsque vous sélectionnez le nom de l'application sur l'onglet Applications OAuth, vous accédez désormais à cet écran.

Utilisez les onglets de cet écran pour :

• Détails :

  • Créer une entrée de store pour l'application

  • Transférer la propriété de l'application

  • Supprimer l'application

• Paramètres : gérer les paramètres de l'application

• Clés et secret :
  • Copier la clé Identifiant client OAuth
  • Régénérer une nouvelle clé Secret client OAuth

• Autorisations : modifiez les limites d'autorisation des applications

• Extensions : gérez les extensions des applications

• OAuth Onshape : gérez l'authentification Onshape

• OAuth externe : gérez l'authentification par des tiers

Consultez la documentation d'Onshape pour les développeurs pour plus d'informations, notamment : s'authentifier correctement avec OAuth2 et remplir la Liste de contrôle de lancement. Consultez le tutoriel Hello World pour découvrir un exemple concret.

1. Cliquez sur l'onglet Applications OAuth sur la page Développeur, puis sélectionnez votre application.

2. Cliquez sur l'onglet Extensions.

   

3. Cliquez sur Ajouter une extension.

4. Remplissez le formulaire :

   • Nom : peut être tronqué dans l'interface utilisateur si elle est trop longue.

   • Description (facultatif) : n'apparaît pas dans l'interface utilisateur d'Onshape, mais pourrait apparaître dans le processus d'authentification.

   • Emplacement : où se trouve l'extension dans l'interface utilisateur d'Onshape.

     • Consultez la section Emplacements et contextes pris en charge dans la Documentation pour les développeurs.

     • Vous ne pouvez créer qu'une seule extension d'onglet d'élément par application.

   • Contexte : certains emplacements fonctionnent dans le contexte d'une sélection, par exemple dans un Part Studio.

     • Consultez la section Emplacements et contextes pris en charge dans la Documentation pour les développeurs.

   • URL de l'action : les sites qui intègrent une interface utilisateur utilisent l'URL de l'action pour définir l'adresse de la page à afficher. L'URL de l'action est utilisée pour spécifier le point final REST si l'emplacement correspond à une action (menu contextuel, élément de la barre d'outils, action dans une boîte de dialogue, etc.) et si le type d'action est GET ou POST. Si l'emplacement correspond à une action et que l'action est Ouvrir dans une nouvelle fenêtre, l'URL de l'action est celle qui s'ouvre dans la nouvelle fenêtre.

     • Consultez la section Paramètres de l'URL de l'action dans la Documentation pour les développeurs afin d'obtenir la liste des paramètres pouvant être utilisés dans ce champ.

   • Type d'action : Applicable aux emplacements qui n'intègrent pas d'interface utilisateur. Les types d'actions pris en charge sont les suivants :

     • GET - Cette commande effectue un appel API GET en utilisant l'URL de l'action. Le remplacement des paramètres s'effectue sur l'URL de l'action.

     • POST - Cette commande effectue un appel API POST en utilisant l'URL de l'action et le corps de l'action comme corps de la requête POST. Le remplacement des paramètres s'effectue à la fois sur l'URL de l'action et sur le corps de l'action.

     • Ouvrir dans une nouvelle fenêtre. L'URL de l'action s'ouvre dans une nouvelle fenêtre de navigateur. Le remplacement des paramètres se fait sur l'URL de l'action.

   • Corps de l'action - Applicable uniquement aux types d'action POST. Le corps de l'action est transmis lors d'un appel API POST et doit être dans un format JSON valide.

   • Afficher la réponse - Cette option n'est disponible que si le type d'action est GET ou POST. Lorsqu'elle est sélectionnée, l'interface utilisateur attend la réponse et l'affiche dans une boîte de dialogue. La réponse doit être dans un format JSON valide.

   • Icône - L'icône s'affiche là où l'extension est présente, notamment dans un panneau d'informations, une action du menu contextuel, un bouton de la barre d'outils, un bouton d'action dans une boîte de dialogue ou tout autre emplacement pris en charge.

5. Cliquez sur OK.

Pour plus d'informations sur la création et la gestion des applications Onshape, veuillez consulter la Documentation pour développeurs Onshape. Consultez le tutoriel Hello World pour découvrir un exemple concret.

Les administrateurs peuvent ajouter des utilisateurs internes aux applications à des fins de test avant de les soumettre à l'App Store Onshape. Les utilisateurs ainsi ajoutés voient automatiquement s'afficher les extensions d'application associées dans leur interface utilisateur Onshape, sans avoir à s'abonner via l'App Store.

1. Une fois votre application enregistrée, cliquez sur Applications dans le volet de gauche.

2. Sélectionnez l'application dans la liste.

   

3. Commencez à saisir le nom ou l'adresse e-mail d'un utilisateur, d'une équipe ou d'un alias dans le champ Ajouter des utilisateurs ou des équipes, puis sélectionnez un résultat dans la liste. L'administrateur qui a créé l'application figure automatiquement dans la liste des utilisateurs. Continuez à ajouter des noms ou des adresses e-mail.

   

4. Cliquez sur le bouton Ajouter.

Les utilisateurs avec profil restreint ne peuvent pas être ajoutés aux applications.

Pour supprimer un utilisateur, un alias ou une équipe de l'application, cliquez sur son icône X dans la colonne Supprimer.

1. Dans vos paramètres Développeur, cliquez sur Applications OAuth.
2. Cliquez sur le nom de l'application à transférer.
3. Cliquez sur le bouton Transfert de propriété dans l'onglet Détails. La boîte de dialogue Transfert de propriété s'ouvre.

   

4. Sélectionnez une option pour transférer l'application à une personne, une société ou une entreprise.
5. Pour transférer la propriété à une personne, saisissez le nom ou l'adresse e-mail du nouveau propriétaire dans le champ de recherche. Pour transférer la propriété à une société ou à une entreprise, sélectionnez une option dans la liste déroulante.
6. Cliquez sur Transfert de propriété. L'application est supprimée de votre liste d'applications OAuth.
   • Si l'application est transférée à un compte individuel, son titulaire reçoit une notification par e-mail et l'application apparaît dans son Portail Développeur Onshape.
   • Si l'application est transférée à une autre personne dans un plan Company/Classroom/Enterprise, tous les administrateurs reçoivent une notification par e-mail et l'application apparaît dans leurs paramètres Développeur.

La consommation et la facturation des futurs appels à une API seront attribuées au nouveau propriétaire. Consultez la section Limites d'API pour plus de détails.

1. Cliquez sur Développeur dans le volet de gauche des paramètres de la société, cliquez sur Applications OAuth, puis sélectionnez l'application que vous souhaitez obsolétiser.
2. Cliquez sur le bouton Statut pour afficher le statut actuel de l'application et les changements de statut pris en charge. Les statuts pris en charge sont les suivants :
   • Active - L'application est disponible sur l'App Store Onshape.
   • Obsolète - L'application n'est plus disponible sur l'App Store, mais les utilisateurs actuels peuvent y accéder.
   • Mise à la corbeille - L'application est retirée de l'onglet Applications OAuth et déplacée vers l'onglet Corbeille.

     • La mise à la corbeille n'est autorisée qu'à l'expiration de tous les abonnements payants.

     • Tous les achats et toutes les attributions sont supprimés.

   • Supprimée - L'application est définitivement supprimée de la Corbeille. Cela ne peut être annulé.
     
3. Sélectionnez le changement de statut souhaité.
4. Tapez le nom de l'application et cliquez à nouveau pour confirmer dans la boîte de dialogue.

Pour créer une nouvelle entrée de store pour une application OAuth :

1. Cliquez sur Applications OAuth sur la page Développeur, puis sélectionnez votre application.

2. Cliquez sur le bouton Créer une entrée de store sur l'onglet Détails de l'application.

   

3. Remplissez le formulaire :

   • Nom - Déterminé automatiquement à partir du nom de l'application fourni lors de l'enregistrement.

   • Résumé - Paramétré automatiquement à partir du résumé fourni lors de l'enregistrement.

   • Type - Type d'application : Application cloud intégrée, Application cloud connectée ou Application de bureau connectée. Ce type doit correspondre au type sélectionné lors de l'enregistrement de l'application OAuth.

   • Catégorie - Sélectionnez la catégorie appropriée pour votre application.

   • Visibilité de l'équipe - Choisissez de rendre l'entrée de l'App Store privée visible pour aucun utilisateur interne (par défaut), pour tous les utilisateurs internes ou pour des équipes spécifiques.

   • Description - Description de l'application destinée aux utilisateurs. La mise en forme est limitée.

   • URL d'assistance - URL ou adresse e-mail vers laquelle les utilisateurs de votre application doivent être redirigés pour obtenir de l'aide. Cette page doit faire l'objet d'un suivi actif.

   • E-mail d'assistance - Adresse e-mail devant recevoir les notifications d'abonnement à l'application. Elle doit faire l'objet d'un suivi actif.

   • Fournisseur - Nom de votre société.

   • Version - Version actuelle de cette application.

   • Images - Vous pouvez, si vous le souhaitez, mettre en ligne des images de résumé, des images d'en-tête et d'autres images.

4. Cliquez sur Créer.

L'application apparaît dans l'App Store Onshape en tant qu'application privée. Elle n'est visible que par vous et par les équipes internes spécifiées dans les paramètres de visibilité pour les équipes. Pour rendre l'application publique, consultez la Liste de contrôle de lancement ci-dessous.

Pour revenir à cet écran, cliquez sur l'onglet Entrée de store et sélectionnez l'application :

1. Cliquez sur l'ongletEntrée de store sur la page Développeur, puis sélectionnez votre application.
2. Cliquez sur Supprimer l'entrée de store.
   
3. Cliquez à nouveau sur Supprimer pour confirmer.