Documentazione di Oracle Cloud Infrastructure

Avvio rapido

Inizia rapidamente a utilizzare l'API REST dei domini di Identity completando i prerequisiti, installando curl e impostando l'autorizzazione per gestire le risorse del dominio di Identity, ad esempio utenti, gruppi e applicazioni.

Prerequisiti

  1. Acquistare una sottoscrizione a Oracle Cloud: consulta la sezione relativa all'acquisto di una sottoscrizione a Oracle Cloud.
  2. Attivare l'ordine: configurare l'account o attivare l'ordine. Vedere Attivazione dell'ordine dal messaggio di posta elettronica di benvenuto in Acquista una sottoscrizione a Oracle Cloud.
  3. Ottenere le credenziali dell'account e l'autorizzazione appropriate per accedere alle API del dominio di Identity dall'amministratore del dominio di Identity.

    • Per collegarsi al dominio di identità. Consultare l'amministratore del dominio di Identity per ottenere il nome utente, la password e il nome del dominio di Identity personali.

    • Utilizzare l'API senza un account utente. Gli amministratori possono utilizzare l'API dei domini di Identity senza un account utente nel dominio di Identity. Per utilizzare l'API dei domini di Identity senza un account utente, richiedere un ID client e un segreto client all'amministratore del dominio di Identity.

Passo 1: collegarsi al dominio di identità

Dopo l'attivazione dell'account, vengono inviate le credenziali di accesso e un collegamento alla home page del dominio di Identity. Selezionare il collegamento nel messaggio e-mail, quindi immettere le credenziali di accesso fornite. Viene visualizzata la home page del dominio di Identity. Vedere Accedi alla console.

Passo 2: Installa cURL

Gli esempi riportati in questo documento utilizzano lo strumento della riga di comando cURL per dimostrare come accedere all'API REST dei domini di Identity.

Per connettersi in modo sicuro al server, è necessario installare una versione di cURL che supporti SSL e fornire un file o un bundle di certificati CA (Certificate Authority) SSL per l'autenticazione con il certificato CA Verisign. Ulteriori informazioni sono disponibili.

La procedura seguente spiega come installare cURL su un sistema a 64 bit di Windows.

  1. In un browser, accedere alla home page cURL all'indirizzo http://curl.haxx.se/download.html.

  2. Nella pagina cURL Releases and Downloads, trovare la versione SSL-enabled corrispondente al sistema operativo, quindi selezionare il collegamento per scaricare il file ZIP.

  3. Installare il software.

  4. Passare alla pagina Certificati CA cURL all'indirizzo http://curl.haxx.se/docs/caextract.html, quindi scaricare il bundle di certificati CA (Certificate Authority) SSL CA-bundle.crt nella cartella in cui è stato installato cURL.

  5. Impostare la variabile di ambiente cURL:

    1. Aprire una finestra dei comandi.

    2. Andare alla directory in cui è stato installato cURL.

    3. Impostare la variabile di ambiente cURL (CURL_CA_BUNDLE) sulla posizione del bundle di certificati SSLCA. Ad esempio: C:\curl> set CURL_CA_BUNDLE=ca-bundle.crt.

Passo 3: Comprendere il formato URL risorsa

Per accedere all'API REST dei domini di Identity, utilizzare un URL che include l'endpoint REST, la risorsa a cui si desidera accedere ed eventuali parametri di query da includere in una richiesta.

L'endpoint di base per l'API REST dei domini di Identity è:

https://<domainURL>/admin/v1/

Per dettagli specifici sulla creazione di questi URL, vedere Invia richieste.

Passo 4: impostazione dell'autorizzazione

È necessario generare il token di accesso che è quindi possibile utilizzare per autorizzare le richieste inviate all'API REST dei domini di Identity. Vedere Gestione dell'autorizzazione mediante l'API.

Ora è possibile inviare richieste a un dominio di Identity utilizzando cURL.

Passo 5: gestire le risorse del dominio di Identity

Inizia a utilizzare l'API REST per gestire configurazioni, identità e risorse complessive del dominio di Identity.