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

• Créer une application interne dans les paramètres de la société sans accéder au portail de développement de l'App Store.

• Gérer l'application en interne.

• Afficher, créer et supprimer les clés API de tout le monde dans la société.

• Consultez l'utilisation des API pour l'entreprise, consultez la section Limites des API pour plus d'informations sur l'utilisation des API.

  Notification emails are sent to all Company/Classroom/Enterprise Admins at 25%, 50%, 75%, and 100% of usage.

1. Cliquez sur le lien des applications OAuth :

   

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

   

3. Remplissez les informations comme suit (notez que des informations détaillées sont également fournies à l'écran) :

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

   • Format principal - Chaîne unique permettant d'identifier votre application qui n'est pas affichée à l'utilisateur.

   • Résumé - Informations relatives à l'application.

   • URL de redirection - URL vers laquelle vous êtes redirigé(e) après authentification.

   • Type - Type d'application. Les options sont l'application cloud intégrée, l'application cloud connectée ou l'application de bureau connectée.

   • URL OAuth - URL utilisée pour démarrer le processus OAuth depuis la page Applications Onshape.

   • 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. Utilisez le champ Rechercher des membres pour localiser et sélectionner les utilisateurs que vous souhaitez ajouter au développement et/ou au test de l'application.

6. L'écran Autoriser l'application pour autoriser l'accès à l'application est fourni à l'utilisateur :

   

7. Pour plus d'informations sur l'authentification de vos applications avec OAuth, consultez le Guide des API : Authentification.

1. Dans vos paramètres de développeur, cliquez sur Applications OAuth.
2. Cliquez sur le nom de l'application à transférer.
3. Cliquez sur le bouton Transférer la propriété dans l'onglet Détails. La boîte de dialogue Transférer 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.
   • If the app was transferred to an individual, they will receive an email notification and the app appears in their Onshape Developer Portal.
   • If the app was transferred to a Company/Classroom/Enterprise, all Admins receive an email notification and the app appears in their Developer Settings.

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.

Toutes les applications soumises sur l'App Store Onshape (Onshape Apps) doivent suivre les instructions de la page Guide des API : OAuth2 et utiliser OAuth2 pour l'autorisation. Les scripts d'automatisation (ou les applications qui ne sont pas destinées à l'App Store Onshape) peuvent utiliser OAuth2 ou des clés API pour s'authentifier. OAuth2 permet aux applications d'appeler les API Onshape pour le compte des utilisateurs de l'application ; les clés API n'effectueront les opérations que pour le compte de l'utilisateur Onshape qui les a générées.

Les clés API sont un moyen utile de créer de petites applications destinées à un usage personnel, ce qui permet aux développeurs de s’épargner la charge des flux de travail OAuth.

Les clés API sont utilisées pour authentifier une application, et non ses utilisateurs. (OAuth2 authentifie une application et ses utilisateurs en s'assurant qu'ils sont autorisés à accéder à Onshape.) Une fois que vous avez créé une clé API, elle n'est valide que dans la pile sur laquelle elle a été créée. Une clé API créée sur MonEntreprise.onshape.com ne fonctionnera pas sur cad.onshape.com.

Les clés API qui ne sont pas associées à une société ou à une entreprise peuvent être gérées via la page Mon compte - Développeur.

Affichage des clés d'API

1. Dans les paramètres Développeur de votre plan Company/Classe/Enterprise, cliquez sur Clés API
2. Consultez les clés API disponibles pour la société.
   
   

Création de clés d'API

1. Dans les paramètres Développeur de votre plan Company/Classe/Enterprise, cliquez sur Clés API
2. Cliquez sur Créer une nouvelle clé d'API.
   
3. Entrez le nom de la clé API dans le champ Nom.

4. Assignez la clé API à un membre de la société. Vous pouvez effectuer une recherche par nom ou par adresse e-mail dans le champ Utilisateur.

5. Choisissez les autorisations pour les clés. Consultez la section Étendue des autorisations ci-dessous.
6. Cliquez sur le bouton Créer une clé d'API.

7. Dans la fenêtre contextuelle, copiez la clé API et la clé secrète affichées, enregistrez-les quelque part, puis cliquez sur le bouton Fermer.

   Vous ne pourrez plus retrouver la clé secrète, alors gardez-la dans un endroit sûr !

   

8. Pour plus d'informations sur l'authentification de vos applications à l'aide de clés d'API, consultez le Guide des API : Authentification.

Suppression des clés d'API

1. Cliquez sur l'icône « X » à droite de la clé d'API que vous souhaitez supprimer.
2. Confirmez que vous souhaitez supprimer cette clé d'API pour tous les utilisateurs. Cette action ne peut pas être annulée. Cliquez sur Supprimer pour confirmer.
   

Les étendues d'autorisation suivantes sont disponibles lors de la création d'applications OAuth :

• L'application peut lire les informations de votre profil (OAuth2ReadPii) - Cochez cette case pour autoriser l'application à accéder aux informations de votre profil.

• L'application peut lire vos documents (OAuth2read) - Cochez cette case pour autoriser l'application à accéder à vos documents en lecture.

• L'application peut écrire dans vos documents (OAuth2Write) - Cochez cette case pour autoriser l'application à accéder à vos documents en écriture.

• L'application peut supprimer vos documents et espaces de travail (OAuth2Delete) - Cochez cette case pour autoriser l'application à accéder à vos documents et espaces de travail.

• L'application peut demander des achats en votre nom (OAuth2Purchase) - Cochez cette case pour autoriser l'application à effectuer des achats pour vous.

• L'application peut partager et annuler le partage de documents en votre nom (OAuth2share) : cochez cette case pour autoriser l'application à partager et annuler le partage de vos documents.