Impostazioni Azienda/Aula/Enterprise - Sviluppatore

1. Fai clic sul collegamento delle applicazioni OAuth:

   

2. Fai clic sul pulsante Crea nuova applicazione OAuth:

   

3. Compila le informazioni come segue (tieni presente che le informazioni dettagliate sono fornite anche sullo schermo):

   • Nome: nome dell'applicazione visualizzata agli utenti.

   • Formato principale: stringa univoca per identificare l'applicazione che non è visualizzata all'utente.

   • Riepilogo: informazioni sull'applicazione.

   • URL di reindirizzamento: URL a cui sarai reindirizzato dopo l'autenticazione.

   • Tipo: tipo di applicazione. Le opzioni sono App cloud integrata, App cloud connessa o App desktop connessa.

   • URL OAuth: URL utilizzato per avviare il processo OAuth dalla pagina applicazioni Onshape.

   • Impostazioni

     • Supporta la collaborazione: seleziona la casella se desideri collaborare con altri utenti durante lo sviluppo dell'applicazione.

   • Autorizzazioni: vedi Ambiti autorizzazioni di seguito.

4. Fai clic su Crea applicazione.

5. Utilizza il campo Cerca partecipanti per individuare e selezionare gli utenti che possono partecipare allo sviluppo e/o al test dell'applicazione.

6. La schermata Autorizza l'applicazione per consentire l'accesso all'applicazione è fornita all'utente:

   

7. Per informazioni sull'autenticazione delle applicazioni con OAuth, consulta la Guida API: autenticazione.

Tutte le applicazioni inviate all'App Store di Onshape (Onshape Apps) devono seguire le istruzioni nella guida API: pagina OAuth2 e utilizzare OAuth2 per l'autorizzazione. Gli script di automazione (o le applicazioni non pensate per l'App Store di Onshape) possono utilizzare OAuth2 o chiavi API per l'autenticazione. OAuth2 consente alle applicazioni di chiamare le API Onshape per conto degli utenti dell'applicazione; le chiavi API eseguiranno operazioni solo per conto dell'utente Onshape che ha generato le chiavi API.

Le chiavi API sono un modo utile di creare piccole applicazioni destinate all'uso personale, consentendo agli sviluppatori di evitare il sovraccarico del flusso di lavoro OAuth.

Le chiavi API sono utilizzate per autenticare un'applicazione, non i suoi utenti. (OAuth2 autentica un'applicazione e gli utenti dell'applicazione, garantendo che gli utenti siano autorizzati ad accedere a Onshape.) Una volta creata una chiave API, questa è valida solo nello stack in cui è stata creata. Una chiave API creata su CompanyName.onshape.com non funzionerà su cad.onshape.com.

Le chiavi API non associate a un'azienda o Enterprise sono gestibili tramite la pagina Il mio account - Sviluppatore.

Visualizzare le chiavi API

1. Nelle tue impostazioni Azienda/Aula/Enterprise Developer, fai clic su Chiavi API
2. Esamina le chiavi API disponibili per l'azienda.
   
   

Creare chiavi API

1. Nelle tue impostazioni Azienda/Aula/Enterprise Developer, fai clic su Chiavi API
2. Fai clic su Crea nuova chiave API.
   
3. Fornisci un nome per la chiave API nel campo Nome.

4. Assegna la chiave API a un utente dell'azienda. Puoi cercare per nome o email nel campo Utente.

5. Scegli le autorizzazioni per le chiavi. Vedi Ambiti di autorizzazione di seguito.
6. Fai clic sul pulsante Crea chiave API.

7. Nella finestra pop-up, copia la chiave API e la chiave segreta visualizzate, salvale da qualche parte, quindi fai clic sul pulsante Chiudi.

   Non sarai più in grado di ritrovare la chiave segreta, quindi salvala in un posto sicuro!

   

8. Per informazioni sull'autenticazione delle applicazioni con le chiavi API, consulta la Guida API: autenticazione.

Eliminare le chiavi API

1. Fai clic sull'icona X a destra della chiave API che desideri eliminare.
2. Conferma che vuoi eliminare questa chiave API per tutti gli utenti. Questa azione non è annullabile. Fai clic su Elimina per confermare.
   

I seguenti ambiti di autorizzazione sono disponibili durante la creazione di applicazioni OAuth:

• L'applicazione può leggere le informazioni del tuo profilo (OAuth2ReadPII): seleziona l'opzione per consentire all'applicazione di accedere alle informazioni sul tuo profilo.

• L'applicazione può leggere i tuoi documenti (OAuth2Read): seleziona l'opzione per consentire all'applicazione di accedere in lettura ai tuoi documenti.

• L'applicazione può scrivere sui tuoi documenti (OAuth2Write): seleziona l'opzione per consentire all'applicazione di accedere in scrittura ai tuoi documenti.

• L'applicazione può eliminare i tuoi documenti e le tue aree di lavoro (OAuth2Delete): seleziona l'opzione per consentire all'applicazione di accedere ed eliminare i documenti e le aree di lavoro.

• L'applicazione può richiedere acquisti per tuo conto (OAuth2Purchase): seleziona l'opzione per consentire all'applicazione di effettuare acquisti per te.

• L'applicazione può condividere e interrompere la condivisione di documenti per tuo conto (OAuth2Share): seleziona l'opzione per consentire all'applicazione la possibilità di condividere e annullare la condivisione dei tuoi documenti.