Documentación de Oracle Cloud Infrastructure

Inicio rápido

Comience rápidamente con la API de REST de los dominios de identidad completando los requisitos, instalando curl y configurando la autorización para gestionar los recursos del dominio de identidad, como usuarios, grupos y aplicaciones.

Requisitos

  1. Comprar una suscripción a Oracle Cloud: consulte Compra una suscripción a Oracle Cloud.
  2. Activar su orden: configure su cuenta o active su orden. Consulte Activación de la orden desde el correo electrónico de bienvenida en Compra 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. 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 los dominios de identidad sin una cuenta de usuario en el dominio de identidad. Para utilizar la API de los 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 al dominio de identidad

Después de activar la cuenta, se le envían las credenciales de conexión y un enlace a la página de inicio del dominio de identidad. Seleccione el enlace en el correo electrónico y, a continuación, introduzca las credenciales de inicio de sesión proporcionadas. Aparece la página de inicio del dominio de identidad. Consulte Sign In to the Console.

Paso 2: Instalar cURL

En los ejemplos de este documento se utiliza 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 archivo o paquete 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, navegue 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 corresponda a su sistema operativo y, a continuación, seleccione 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 del entorno cURL:

    1. Abra una ventana de comandos.

    2. Navegue hasta el directorio donde instaló 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, a continuación, puede utilizar para autorizar las solicitudes que envía a la API de REST de los dominios de identidad. Consulte Gestión de autorización mediante la API.

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

Paso 5: Gestionar los recursos de dominio de identidad

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