Documentación de Oracle Cloud Infrastructure

Inicio rápido

Para empezar a utilizar rápidamente la API de REST de los dominios de identidad, complete los requisitos, instale curl y configure la autorización para gestionar sus recursos de dominio de identidad, como usuarios, grupos y aplicaciones.

Requisitos

  1. Adquisición de una suscripción a Oracle Cloud: consulte Adquisición de una suscripción a Oracle Cloud.
  2. Active su pedido: configure su cuenta o active su pedido. Consulte Activación de la orden desde el correo electrónico de bienvenida en Comprar una suscripción a Oracle Cloud.
  3. Obtenga las credenciales de cuenta y la autorización adecuadas para acceder a las API del dominio de identidad del administrador del dominio de identidad:

    • Para conectarse a su dominio de identidad. Consulte al administrador del dominio de identidad para obtener su nombre de usuario, contraseña y nombre de dominio de identidad.

    • Para utilizar la API sin una cuenta de usuario. Los administradores pueden utilizar la API de dominios de identidad sin una cuenta de usuario en el dominio de identidad. Para utilizar la API de dominios de identidad sin una cuenta de usuario, solicite un ID de cliente y un secreto de cliente al administrador del dominio de identidad.

Paso 1: Conectarse a su dominio de identidad

Después de activar la cuenta, se le enviarán credenciales de conexión y un enlace a la página de inicio del dominio de identidad. Haga clic en el enlace del correo electrónico y, a continuación, introduzca las credenciales de inicio de sesión proporcionadas. Aparece la página inicial del dominio de identidad. Consulte Conexión a la consola.

Paso 2: Instalar cURL

Los ejemplos de este documento utilizan la herramienta de línea de comandos cURL para demostrar cómo acceder a la API de REST de los dominios de identidad.

Para conectarse de forma segura al servidor, debe instalar una versión de cURL que admita SSL y proporcionar un paquete o archivo de certificado de autoridad de certificación (CA) SSL para autenticarse en el certificado de CA de Verisign. Para obtener más información sobre:

El siguiente procedimiento muestra cómo instalar cURL en un sistema Windows de 64 bits.

  1. En un explorador, vaya a la página de inicio de cURL en http://curl.haxx.se/download.html.

  2. En la página Versiones y descargas de cURL, busque la versión habilitada para SSL que corresponde a su sistema operativo y, a continuación, haga clic en el enlace para descargar el archivo ZIP.

  3. Instale el software.

  4. Navigate to the cURL CA Certs page at http://curl.haxx.se/docs/caextract.html, and then download the ca-bundle.crt SSL certificate authority (CA) certificate bundle into the folder where you installed cURL.

  5. Defina la variable de entorno cURL:

    1. Abra una ventana de comandos.

    2. Vaya al directorio en el que ha instalado cURL.

    3. Defina la variable de entorno cURL (CURL_CA_BUNDLE) en la ubicación del grupo de certificados SSLCA. Por ejemplo: C:\curl> set CURL_CA_BUNDLE=ca-bundle.crt.

Paso 3: Descripción del formato de URL de recurso

Puede acceder a la API de REST de los dominios de identidad mediante una URL, que incluye el punto final de REST, el recurso al que desea acceder y cualquier parámetro de consulta que desee incluir en una solicitud.

El punto final básico para la API de REST de los dominios de identidad es:

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

Consulte Enviar solicitudes para obtener detalles específicos sobre la creación de estas URL.

Paso 4: Configurar autorización

Debe generar el token de acceso que puede utilizar para autorizar las solicitudes que envíe a la API de REST de los dominios de identidad. Consulte Gestión de autorizaciones mediante la API.

Ya puede enviar solicitudes a un dominio de identidad mediante cURL.

Paso 5: Gestión de los recursos del dominio de identidad

Empiece a utilizar la API de REST para gestionar los recursos y las identidades generales del dominio de identidad.