Documentation Oracle Cloud Infrastructure

démarrage rapide

Commencez rapidement à utiliser l'API REST des domaines d'identité en remplissant les prérequis, en installant curl et en configurant l'autorisation de gestion des ressources de domaine d'identité, telles que les utilisateurs, les groupes et les applications.

Prérequis

  1. Achat d'un abonnement Oracle Cloud : reportez-vous à Achat d'un abonnement Oracle Cloud.
  2. Activer votre commande : Configurez votre compte ou activez votre commande. Reportez-vous à Activate Your Order from Your Welcome Email dans Achat d'un abonnement Oracle Cloud.
  3. Obtenez les informations d'identification de compte et l'autorisation appropriées pour accéder aux API de domaine d'identité auprès de l'administrateur de domaine d'identité :

    • Pour vous connecter à votre domaine d'identité, procédez comme suit : Contactez l'administrateur de domaine d'identité pour obtenir votre nom utilisateur, votre mot de passe et votre nom de domaine d'identité.

    • Pour utiliser l'API sans compte utilisateur. Les administrateurs peuvent utiliser l'API des domaines d'identité sans compte utilisateur dans le domaine d'identité. Pour utiliser l'API de domaines d'identité sans compte utilisateur, demandez un ID client et une clé secrète client à l'administrateur de domaine d'identité.

Etape 1 : connectez-vous à votre domaine d'identité

Une fois votre compte activé, des informations d'identification de connexion et un lien vers la page d'accueil du domaine d'identité vous sont envoyés. Cliquez sur le lien dans l'e-mail, puis entrez les informations d'identification de connexion fournies. La page d'accueil de votre domaine d'identité apparaît. Reportez-vous à Connexion à la console.

Etape 2 : Installer cURL

Les exemples de ce document utilisent l'outil de ligne de commande cURL pour montrer comment accéder à l'API REST des domaines d'identité.

Pour vous connecter en toute sécurité au serveur, vous devez installer une version de cURL qui prend en charge SSL et fournir un fichier ou un bundle de certificats d'autorité de certification SSL pour l'authentification par rapport au certificat d'autorité de certification Verisign. Pour plus d'informations sur :

La procédure suivante explique comment installer cURL sur un système Windows 64 bits.

  1. Dans un navigateur, accédez à la page d'accueil cURL à l'adresse http://curl.haxx.se/download.html.

  2. Sur la page Versions et téléchargements cURL, recherchez la version SSL qui correspond à votre système d'exploitation, puis cliquez sur le lien pour télécharger le fichier ZIP.

  3. Installez le logiciel.

  4. Accédez à la page Certs d'autorité de certification cURL à l'adresse http://curl.haxx.se/docs/caextract.html, puis téléchargez le groupe de certificats d'autorité de certification SSL CA-bundle.crt dans le dossier où vous avez installé cURL.

  5. Définissez la variable d'environnement cURL :

    1. Ouvrez une fenêtre de commande.

    2. Accédez au répertoire dans lequel vous avez installé cURL.

    3. Définissez la variable d'environnement cURL (CURL_CA_BUNDLE) sur l'emplacement du groupe de certificats SSLCA. Par exemple : C:\curl> set CURL_CA_BUNDLE=ca-bundle.crt.

Etape 3 : Comprendre le format d'URL de ressource

Vous accédez à l'API REST des domaines d'identité à l'aide d'une URL, qui inclut l'adresse REST, la ressource à laquelle vous souhaitez accéder et tous les paramètres de requête à inclure dans une demande.

L'adresse de base de l'API REST des domaines d'identité est la suivante :

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

Pour plus d'informations sur la création de ces URL, reportez-vous à Envoyer des demandes.

Etape 4 : Configurer l'autorisation

Vous devez générer le jeton d'accès que vous pouvez ensuite utiliser pour autoriser les demandes que vous envoyez à l'API REST des domaines d'identité. Reportez-vous à Gestion de l'autorisation à l'aide de l'API.

Vous êtes maintenant prêt à envoyer des demandes à un domaine d'identité à l'aide de cURL.

Etape 5 : gestion des ressources de domaine d'identité

Commencez à utiliser l'API REST pour gérer les configurations de domaine d'identité globales, ainsi que les identités et les ressources.