Autenticazione

Le API DigiCert CertCentral utilizzano le chiavi API sia per l’autenticazione che per l’autorizzazione. L’autenticazione nel servizio deve essere relativamente chiara se hai mai lavorato con l’autenticazione basata su intestazione.

Autenticazione basata su intestazione

Ciascun richiesta al servizio deve includere una chiave API. Ciò avviene usando l’intestazione HTTP personalizzata X‑DC‑DEVKEY. Ecco una semplice richiesta API all’endpoint Elenca utenti di Services API usando cURL.

Accertati di sostituire {{api_key}} con la tua chiave API reale.

bash
curl -X GET \
  'https://www.digicert.com/services/v2/user' \
  -H 'Content-Type: application/xml' \
  -H 'X-DC-DEVKEY: {{api_key}}'

Genera una chiave API

Dopo aver generato una chiave, la visualizziamo solo una volta. Non vi sono modi per recuperare una chiave API persa. Qualora perdessi una chiave, dovrai revocare la chiave persa e generarne una nuova.

Le chiavi API vengono generate e gestite nel tuo account CertCentral. Per generare una nuova chiave, accedi al tuo account CertCentral.

  1. Nel tuo account CertCentral, nel menu della barra laterale, fai clic su Account > Accesso account.

  2. Nella pagina Accesso account, in Chiavi API, fai clic su Aggiungi chiave API.

  3. Nella finestra Aggiungi chiave API, inserisci una Descrizione per la nuova chiave.

    Ad esempio, inserisci il nome dell’app o dell’utente a cui stai collegando la chiave.

  4. Nel menu a discesa Utente, seleziona l’utente a cui desideri collegare la chiave.

Ricordati che, quando colleghi una chiave ad un utente, colleghi le autorizzazioni di quell’utente alla chiave. Ciò significa che la chiave sarà autorizzata ad eseguire qualsiasi azione che l’utente può fare.

  1. (Questa fase è facoltativa) Per limitare le autorizzazioni delle chiavi API ad una serie specificata di azioni, nel menu a discesa Limiti chiave API (opzionale), seleziona uno di queste opzioni:

  2. Fai clic su Aggiungi chiave API.

  3. Nella finestra Nuova chiave API, fai clic sulla chiave generata per copiarla.

  4. Salva la chiave in una posizione sicura. (Ricorda: la chiave viene visualizzata solo questa volta.)

  5. Dopo aver salvato la chiave, fai clic su Capisco che non verrà più mostrato.

Passaggi successivi

Ora sei pronto per iniziare a usare le API DigiCert CertCentral. La tua nuova chiave API viene aggiunta all’elenco delle chiavi sulla pagina Accesso account. Torna in questa pagina per monitorare le chiavi API (attive e revocate) o revocarle.

Modifica una chiave API

Se necessario, puoi modifica una chiave API per aggiornare la descrizione o per modificare le autorizzazioni delle chiavi.

  1. Nel tuo account CertCentral, nel menu della barra laterale, fai clic su Account > Accesso account.

  2. Nella pagina Accesso account, in Chiavi API, fai clic sul link Nome chiave API.

  3. Nella finestra Aggiorna chiave API, modifica la Descrizione o aggiorna le autorizzazioni della chiave API.

  4. Per rimuovere i limiti della chiave API, nel campo Limiti chiave API (opzionale), fai clic sulla X alla fine dell’inserimento. Il campo ora visualizzerà Nessuno.

  5. Per aggiornare le autorizzazioni delle chiavi API, nel menu a discesa Limiti chiave API (opzionale), seleziona uno di queste opzioni:

Ricordati che, quando aggiungi dei limiti di autorizzazione ad una chiave API attiva, rimuoverai tutte le integrazioni che utilizzano quella chiave se sono necessarie autorizzazioni estese. Per risolvere la rimozione di queste integrazioni, dovrai modificare la chiave e rimuovere le limitazioni.

  1. Fai clic su Aggiungi chiave API per l’aggiornamento.

Informazioni correlate