Documentação do Oracle Cloud Infrastructure

Início Rápido

Comece a usar rapidamente a API REST de domínios de identidades concluindo pré-requisitos, instalando curl e configurando autorização para gerenciar seus recursos de domínio de identidades, como usuários, grupos e aplicativos.

Pré-requisitos

  1. Comprar uma Assinatura do Oracle Cloud: Consulte Comprar uma Assinatura do Oracle Cloud.
  2. Ativar seu pedido: Configure sua conta ou ative seu pedido. Consulte Ativar Seu Pedido pelo E-mail de Boas-vindas em Comprar uma Assinatura do Oracle Cloud.
  3. Obtenha as credenciais da conta e a autorização apropriadas para acessar APIs do domínio de identidades do administrador do domínio de identidades:

    • Para acessar seu domínio de identidades. Consulte o administrador do domínio de identidades para obter seu nome de usuário, senha e nome do domínio de identidades.

    • Para usar a API sem uma conta de usuário. Os administradores podem usar a API de domínios de identidades sem uma conta de usuário no domínio de identidades. Para usar a API de domínios de identidades sem uma conta de usuário, solicite um ID do cliente e um segredo do cliente ao administrador do domínio de identidades.

Etapa 1: Acessar seu Domínio de Identidades

Depois de ativar sua conta, você receberá credenciais de acesso e um link para a home page do seu domínio de identidades. Clique no link no e-mail e informe as credenciais de acesso fornecidas. A home page do domínio de identidades é exibida. Consulte Acessar a Console.

Etapa 2: Instalar cURL

Os exemplos neste documento usam a ferramenta de linha de comando cURL para demonstrar como acessar a API REST dos domínios de identidade.

Para estabelecer conexão segura com o servidor, instale uma versão do cURL que suporte SSL e forneça um arquivo ou pacote de certificados da autoridade de certificação (CA) SSL para autenticação no certificado da CA Verisign. Para obter mais informações sobre:

O procedimento a seguir demonstra como instalar o cURL em um sistema Windows de 64 bits.

  1. Em um navegador, acesse a home page do cURL em http://curl.haxx.se/download.html.

  2. Na página Releases and Downloads do cURL, localize a versão habilitada para SSL que corresponde ao seu sistema operacional e clique no link para fazer download do arquivo ZIP.

  3. Instale o software.

  4. Navegue até a página Certificados de CA cURL em http://curl.haxx.se/docs/caextract.html e faça download do pacote de certificados de autoridade de certificação (CA) SSL CA-bundle.crt para a pasta em que você instalou o cURL.

  5. Defina a variável de ambiente cURL:

    1. Abra uma janela de comandos.

    2. Navegue até o diretório em que você instalou o cURL.

    3. Defina a variável de ambiente cURL (CURL_CA_BUNDLE) como a localização do pacote de certificados SSLCA. Por exemplo: C:\curl> set CURL_CA_BUNDLE=ca-bundle.crt.

Etapa 3: Compreender o Formato de URL do Recurso

Você acessa a API REST dos domínios de identidades usando um URL, que inclui o ponto final REST, o recurso que você deseja acessar e quaisquer parâmetros de consulta que você deseja incluir em uma solicitação.

O ponto final básico da API REST de domínios de identidades é:

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

Consulte Enviar Solicitações para obter detalhes específicos sobre como criar esses URLs.

Etapa 4: Configurar Autorização

Você precisa gerar o token de acesso que poderá usar para autorizar solicitações enviadas à API REST dos domínios de identidades. Consulte Gerenciando Autorização Usando a API.

Agora você está pronto para enviar solicitações a um domínio de identidades usando cURL.

Etapa 5: Gerenciar Recursos do Domínio de Identidades

Comece a usar a API REST para gerenciar configurações e identidades e recursos gerais do domínio de identidades.