Usar Autenticação do IAM (Identity and Access Management) com o Autonomous Database

Sobre a Autenticação do IAM (Identity and Access Management) com o Autonomous Database

A integração do Oracle Cloud Infrastructure IAM com o Autonomous Database suporta autenticação de senha de banco de dados e autenticação baseada em token. Consulte Autenticando e Autorizando Usuários do IAM para Oracle Autonomous Databases para obter detalhes completos sobre a arquitetura para usar usuários do IAM no Autonomous Database.

Autenticação de Senha do Banco de Dados do IAM

Observação:

Qualquer cliente de banco de dados com suporte a 12c e posteriores pode ser usado para acesso por senha do banco de dados do IAM ao Autonomous Database.

Uma senha de banco de dados do Oracle Cloud Infrastructure IAM permite que um usuário do IAM faça log-in em uma instância do Autonomous Database, pois os usuários do Oracle Database normalmente fazem log-in com um nome de usuário e uma senha. O usuário informa seu nome de usuário do IAM e a senha do banco de dados do IAM. Uma senha de banco de dados do IAM é uma senha distinta da senha da Console do Oracle Cloud Infrastructure. Usando um usuário do IAM com o verificador de senha, você pode fazer log-in no Autonomous Database com qualquer cliente de banco de dados suportado.

Autenticação Baseada em Token de SSO do IAM (Identity and Access Management)

Há várias formas pelas quais um cliente de banco de dados pode obter um token de banco de dados do IAM:

Um aplicativo ou ferramenta cliente pode solicitar o token de banco de dados do IAM para o usuário e pode passar o token de banco de dados por meio da API do cliente. O uso da API para enviar o token substitui outras definições no cliente de banco de dados. Esse tipo de uso de token de banco de dados do IAM é suportado para os seguintes clientes:
- JDBC-thin em todas as plataformas
- Oracle Instant Client OCI-C no Linux
- Oracle Data Provider for .NET (ODP.NET) Core
Se o aplicativo ou a ferramenta não oferecer suporte à solicitação de um token de banco de dados do IAM por meio da API do cliente, o usuário do IAM poderá primeiro usar a CLI (interface de linha de comando) do Oracle Cloud Infrastructure para recuperar o token de banco de dados do IAM e salvá-lo em um local de arquivo. Por exemplo, para usar o SQL*Plus e outros aplicativos e ferramentas que usam esse método de conexão, primeiro obtenha o token de banco de dados usando a CLI (Interface de Linha de Comando) do Oracle Cloud Infrastructure (OCI). Se o cliente de banco de dados estiver configurado para tokens de banco de dados do IAM, quando um usuário fizer log-in com o formato de log-in de barra, o driver do banco de dados usará o token do banco de dados do IAM que foi salvo em um local de arquivo padrão ou especificado.
Um aplicativo ou ferramenta cliente pode usar um controlador de recursos ou um controlador de instâncias do Oracle Cloud Infrastructure IAM para obter um token de banco de dados do IAM e usá-lo para se autenticar em uma instância do Autonomous Database.
Os usuários do IAM e os aplicativos OCI podem solicitar um token de banco de dados do IAM com vários métodos, incluindo o uso de uma chave de API. Consulte Configurando uma Conexão do Cliente para o SQL*Plus que Usa um Token do Serviço IAM para obter um exemplo. Consulte Sobre a Autenticação e a Autorização de Usuários do Serviço IAM para um Oracle Autonomous Database para obter uma descrição de outros métodos, como o uso de um token de delegação em um cloud shell do OCI.

Se um usuário informar um nome de usuário/senha para fazer log-in, o driver do banco de dados usará o método verificador de senha para acessar o banco de dados, independentemente da definição de token do banco de dados do cliente.

Pré-requisitos para Autenticação do IAM (Identity and Access Management) no Autonomous Database

Antes de usar a autenticação do IAM (Identity and Access Management) no Autonomous Database, certifique-se de:

Oracle Public Cloud
Exadata Cloud@Customer

Use o serviço Networking para adicionar um gateway de serviço, uma regra de roteamento e uma regra de segurança de saída à VCN (rede virtual na nuvem) e às sub-redes nas quais residem seus recursos do Autonomous Database.

Crie um gateway de serviço na VCN (Rede Virtual na Nuvem) em que seus recursos do Autonomous Database residem seguindo as instruções na Tarefa 1: Criar o gateway de serviço na Documentação do Oracle Cloud Infrastructure.
Depois de criar o gateway de serviço, adicione uma regra de roteamento e uma regra de segurança de saída a cada sub-rede (na VCN) na qual os recursos do Autonomous Database residem para que esses recursos possam usar o gateway para usar a autenticação do IAM (Identity and Access Management):
1. Vá para a página Detalhes da Sub-rede da sub-rede.
2. Na guia Informações da Sub-rede, clique no nome da Tabela de Rota da sub-rede para exibir sua respectiva página Detalhes da Tabela de Rota.
3. Na tabela de Regras de Roteamento existentes, verifique se já existe uma regra com as seguintes características:
  - Destino: Todos os Serviços IAD no Oracle Services Network
  - Tipo de Destino: Gateway de Serviço
  - Destino: O nome do gateway de serviço que você acabou de criar na VCN
  Se essa regra não existir, clique em Adicionar Regras de Rota e adicione uma regra de roteamento com essas características.
4. Retorne à página Detalhes da Sub-rede da sub-rede.
5. Na tabela Listas de Segurança da sub-rede, clique no nome da lista de segurança da sub-rede para exibir a página Detalhes da Lista de Segurança.
6. No menu lateral, em Recursos, clique em Regras de Saída.
7. Na tabela de Regras de Saída existentes, verifique se já existe uma regra com as seguintes características:
  - Sem Monitoramento de Estado: Não
  - Destino: Todos os Serviços IAD no Oracle Services Network
  - Protocolo IP: TCP
  - Intervalo de Portas de Origem: Tudo
  - Faixa de Portas de Destino: 443
8. Se essa regra não existir, clique em Adicionar Regras de Saída e adicione uma regra de saída com essas características.

As definições de Proxy HTTP em seu ambiente devem permitir que o banco de dados acesse o provedor de serviços em nuvem.

Essas definições são definidas pelo administrador da frota ao criar a infraestrutura do Exadata Cloud@Customer, conforme descrito em Usando a Console para Provisionar o Exadata Database Service on Cloud@Customer.

Observação:

A configuração de rede, incluindo o Proxy HTTP, só poderá ser editada até que o Exadata Infrastructure esteja no estado Exige Ativação. Depois de ativado, você não poderá editar essas configurações.

A configuração de um Proxy HTTP para uma Infraestrutura do Exadata já provisionada precisa de uma Solicitação de Serviço (SR) no My Oracle Support. Consulte Criar uma Solicitação de Serviço no My Oracle Support para obter detalhes.

Alterar Provedores de Identidades Externos no Autonomous Database

Descreve as etapas para alterar o provedor de identidades externo da autenticação e autorização do IAM para outro provedor de autenticação externo e vice-versa.

A autenticação e a autorização do Oracle Cloud Infrastructure (IAM) para usuários é ativada para Autonomous Databases e Autonomous Container Databases recém-provisionados, por padrão. Há outros esquemas de autenticação externos, como Usuários Gerenciados Centralmente com Active Directory (CMU-AD), Azure AD e Kerberos, que você pode ativar para seu Autonomous Database. No entanto, só pode haver um esquema de autenticação externo ativado em determinado momento.

Para permitir que os usuários do banco de dados estabeleçam conexão com o Autonomous Database usando outro esquema de autenticação externo:

Desative a integração do IAM usando o procedimento DBMS_CLOUD_ADMIN.DISABLE_EXTERNAL_AUTHENTICATION:
Por exemplo:
```
BEGIN    
  DBMS_CLOUD_ADMIN.DISABLE_EXTERNAL_AUTHENTICATION;
END;
/
```
Para obter informações adicionais, consulte Procedimento DISABLE_EXTERNAL_AUTHENTICATION.
Siga as etapas descritas nas páginas a seguir para configurar outro esquema de autenticação externo de sua escolha:
Reative usuários do IAM para estabelecer conexão com o Autonomous Database usando a Autenticação e Autorização do Oracle Cloud Infrastructure IAM.
Como usuário ADMIN, execute o procedimento DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION com os parâmetros mostrados abaixo:
```
BEGIN
  DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION(
    type => 'OCI_IAM'
    force => TRUE
    );
END;
/
```
O exemplo acima desativa qualquer provedor de autenticação externo que esteja ativado no momento e ativa a Autenticação e a Autorização do Oracle Cloud Infrastructure (IAM).
Neste exemplo:
- force é definido como TRUE para desativar a autenticação externa ativada no momento.
- type é definido como 'OCI_IAM' para ativar e usar Autenticação e Autorização do Oracle Cloud Infrastructure (IAM).
Observação:
Por padrão, o parâmetro force é FALSE. Quando outro método de autenticação externa está ativado e force é FALSE, o DBMS_CLOUD_ADMIN.ENABLE_EXTERNAL_AUTHENTICATION reporta o seguinte erro: ORA-20004: Another external authentication is already enabled.
Consulte Procedimento ENABLE_EXTERNAL_AUTHENTICATION para obter mais referências.

Verifique o valor do parâmetro do sistema IDENTITY_PROVIDER_TYPE, conforme mostrado abaixo:

SELECT NAME, VALUE FROM V$PARAMETER WHERE NAME='identity_provider_type';
NAME                   VALUE   
---------------------- ------- 
identity_provider_type OCI_IAM

Criar Grupos e Políticas do Serviço IAM (Identity and Access Management) para Usuários do IAM

Descreve as etapas para gravar instruções de política para um grupo do IAM a fim de permitir o acesso do usuário do IAM aos recursos do Oracle Cloud Infrastructure, especificamente às instâncias do Autonomous Database.

Uma política é um grupo de instruções que especifica quem pode acessar recursos específicos e como. O acesso pode ser concedido para toda a tenancy, bancos de dados em um compartimento ou bancos de dados individuais. Isso significa que você grava uma instrução de política que dá a um grupo específico um determinado tipo de acesso a um tipo de recurso definido dentro de um compartimento específico.

Observação:

A definição de uma política é necessária para usar tokens do serviço IAM para acessar o Autonomous Database. Não é necessária uma política ao usar senhas de banco de dados do serviço IAM para acessar o Autonomous Database.

Para ativar o Autonomous Database para permitir que os usuários do serviço IAM se conectem ao banco de dados usando tokens do IAM:

Execute os pré-requisitos do Oracle Cloud Infrastructure Identity and Access Management criando um grupo e adicionando usuários ao grupo.

Por exemplo, crie o grupo sales_dbusers.

Consulte Gerenciando Grupos para obter mais informações.
Grave instruções de política para permitir o acesso aos recursos do Oracle Cloud Infrastructure.
1. Na console do Oracle Cloud Infrastructure, clique em Identidade e Segurança.
2. Em Identidade e Segurança, clique em Políticas.
3. Para gravar uma política, clique em Criar Política.
4. Na página Criar Política, informe um Nome e uma Descrição.
5. Na página Criar Política, selecione Mostrar editor manual.
  
  Descrição da ilustração adb_iam_create_policy_manual.png
6. Use o Criador de Política para criar uma política.
  Por exemplo, para criar uma política que permita aos usuários no grupo DBUsers do serviço IAM acessar qualquer Autonomous Database em sua tenancy:
```
Allow group DBUsers to use autonomous-database-family in tenancy
```
  Por exemplo, para criar uma política que limite os membros do grupo DBUsers a acessar o Autonomous Databases somente no compartimento testing_compartment:
```
allow group DBUsers to use autonomous-database-family in compartment testing_compartment 
```
  Por exemplo, para criar uma política que limite o acesso do grupo a um único banco de dados em um compartimento:
```
allow group DBUsers to use autonomous-database-family in compartment testing_compartment where target.database.id = 'ocid1.autonomousdatabase.oc1.iad.aaaabbbbcccc'
```
  Consulte Creating an IAM Policy to Authorize Users Authenticating with Tokens no Database Security Guide para obter mais informações sobre políticas do serviço IAM para acessar o banco de dados.
7. Clique em Criar.
  
  Consulte Gerenciando Políticas para obter mais informações sobre políticas.

Observações para criar políticas para uso com usuários do serviço IAM no Autonomous Database:

As políticas podem permitir que os usuários do IAM acessem instâncias do Autonomous Database em toda a tenancy, em um compartimento, ou podem limitar o acesso a uma única instância do Autonomous Database.
Você pode usar um controlador de instâncias ou um controlador de recursos para recuperar tokens de banco de dados para estabelecer uma conexão do seu aplicativo com uma instância do Autonomous Database. Se estiver usando um controlador de instâncias ou um controlador de recursos, você deverá mapear um grupo dinâmico. Portanto, você não pode mapear exclusivamente instâncias e controladores de recursos; só pode mapeá-los por meio de um mapeamento compartilhado e colocar a instância ou instância de recurso em um grupo dinâmico do serviço IAM.

Você pode criar Grupos Dinâmicos e fazer referência a grupos dinâmicos nas políticas criadas para acessar o Oracle Cloud Infrastructure. Consulte Planejar Controles de Acesso e Criar Recursos de Suporte e Gerenciando Grupos Dinâmicos para obter detalhes.

Adicionar Usuários do serviço IAM no Autonomous Database

Para adicionar usuários do serviço IAM para permitir acesso ao Autonomous Database, mapeie usuários globais do banco de dados para grupos ou usuários do IAM com instruções CREATE USER ou ALTER USER (com a cláusula IDENTIFIED GLOBALLY AS).

A autorização de usuários do serviço IAM para uma instância do Autonomous Database funciona mapeando usuários globais (esquemas) do IAM para usuários do IAM (mapeamento exclusivo) ou grupos (mapeamento de esquema compartilhado) do IAM.

Para autorizar usuários do serviço IAM em uma instância do Autonomous Database:

Faça log-in como o usuário ADMIN no banco de dados que está ativado para usar o serviço IAM (o usuário ADMIN tem os privilégios de sistema CREATE USER e ALTER USER necessários para essas etapas).
Crie um mapeamento entre o usuário (esquema) do Autonomous Database com as instruções CREATE USER ou ALTER USER e inclua a cláusula IDENTIFIED GLOBALLY AS, especificando o nome do grupo do IAM.
Use a seguinte sintaxe para mapear um usuário global para um grupo do serviço IAM:
```
CREATE USER global_user IDENTIFIED GLOBALLY AS 'IAM_GROUP_NAME=IAM_GROUP_NAME';
```
Por exemplo, para mapear um grupo do serviço IAM chamado db_sales_group para um usuário global de banco de dados compartilhado chamado sales_group:
```
CREATE USER sales_group IDENTIFIED GLOBALLY AS
     'IAM_GROUP_NAME=db_sales_group';
```
Isso cria um mapeamento de usuário global compartilhado. O mapeamento, com o usuário global sales_group, é efetivo para todos os usuários do grupo do IAM. Assim, qualquer pessoa no db_sales_group pode fazer log-in no banco de dados usando suas credenciais do IAM (por meio do mapeamento compartilhado do usuário global sales_group).
O exemplo a seguir mostra como fazer isso para um domínio não padrão:
```
CREATE USER shared_sales_schema IDENTIFIED GLOBALLY AS
     'IAM_GROUP_NAME=sales_domain/db_sales_group';
```
Se você quiser criar mapeamentos de usuários globais adicionais para outros grupos ou usuários do IAM, siga estas etapas para cada grupo ou usuário do IAM.

Observação:

Os usuários do banco de dados que não forem IDENTIFIED GLOBALLY poderão continuar fazendo log-in como antes, mesmo quando o Autonomous Database estiver ativado para autenticação do IAM.

Para mapear exclusivamente um usuário local do IAM para um Usuário Global do Oracle Database:

Faça log-in como o usuário ADMIN no banco de dados que está ativado para usar o serviço IAM (o usuário ADMIN tem os privilégios de sistema CREATE USER e ALTER USER necessários para essas etapas).
Crie um mapeamento entre o usuário (esquema) do Autonomous Database com instruções CREATE USER ou ALTER USER e inclua a cláusula IDENTIFIED GLOBALLY AS, especificando o nome de usuário local do IAM.

Por exemplo, para criar um novo usuário global de banco de dados chamado peter_fitch e mapear esse usuário para um usuário local existente do serviço IAM chamado peterfitch:
```
CREATE USER peter_fitch IDENTIFIED GLOBALLY AS 'IAM_PRINCIPAL_NAME=peterfitch'
```
O exemplo a seguir mostra como criar o usuário especificando um domínio não padrão, sales_domain:
```
CREATE USER peter_fitch2 IDENTIFIED GLOBALLY AS
'IAM_PRINCIPAL_NAME=sales_domain/peterfitch';
```

Adicionar Atribuições do Serviço IAM no Autonomous Database

Opcionalmente, crie atribuições globais para fornecer privilégios e atribuições adicionais do banco de dados a usuários do IAM quando vários usuários do IAM forem mapeados para o mesmo usuário global compartilhado.

O uso de atribuições globais é opcional ao usar um mapeamento exclusivo do IAM para o usuário (esquema) ou o mapeamento de usuário compartilhado no Autonomous Database. Por exemplo, todos os privilégios e atribuições podem ser concedidos ao esquema compartilhado e todos os usuários do IAM que mapeiam para o esquema compartilhado recebem os privilégios e as atribuições designados ao esquema compartilhado.

Você pode usar uma atribuição global para diferenciar opcionalmente usuários que usam o mesmo esquema compartilhado. Por exemplo, um conjunto de usuários pode ter o mesmo esquema compartilhado e o esquema compartilhado pode ter o privilégio CREATE SESSION. Em seguida, as atribuições globais podem ser usadas para fornecer privilégios e atribuições diferenciados designados a diferentes grupos de usuários que usam o mesmo esquema compartilhado.

A concessão de atribuições adicionais aos usuários do IAM no Autonomous Database funciona mapeando atribuições globais do Autonomous Database para grupos do IAM.

Para mapear atribuições globais do Autonomous Database para grupos do IAM:

Faça log-in como o usuário ADMIN no banco de dados que está ativado para usar o serviço IAM (o usuário ADMIN tem os privilégios de sistema CREATE USER e ALTER USER necessários para essas etapas).
Defina a autorização do banco de dados para atribuições do Autonomous Database com instruções CREATE ROLE ou ALTER ROLE e inclua a cláusula IDENTIFIED GLOBALLY AS, especificando o nome do grupo do IAM.
Use a seguinte sintaxe para mapear uma atribuição global para um grupo do serviço IAM:
```
CREATE ROLE global_role IDENTIFIED GLOBALLY AS
    'IAM_GROUP_NAME=IAM_GROUP_of_WHICH_the_IAM_USER_IS_a_MEMBER';
```
Por exemplo, para mapear um grupo do serviço IAM chamado ExporterGroup para uma atribuição global de banco de dados compartilhado chamada export_role:
```
CREATE ROLE export_role IDENTIFIED GLOBALLY AS
     'IAM_GROUP_NAME=ExporterGroup';
```
O exemplo a seguir mostra como criar a atribuição especificando um domínio não padrão, sales_domain:
```
CREATE ROLE export_role IDENTIFIED GLOBALLY AS
     'IAM_GROUP_NAME=sales_domain/ExporterGroup';
```
Todos os membros do ExporterGroup no domínio sales_domain serão autorizados com a atribuição global do banco de dados export_role quando fizerem log-in no banco de dados.
Use instruções GRANT para conceder os privilégios necessários ou outras atribuições à atribuição global.
```
GRANT CREATE SESSION TO export_role;
GRANT DWROLE TO export_role;
```
Se você quiser que uma atribuição de banco de dados existente seja associada a um grupo do IAM, use a instrução ALTER ROLE para alterar a atribuição de banco de dados existente para mapear a atribuição para um grupo do IAM. Use a seguinte sintaxe para alterar uma atribuição de banco de dados existente para mapeá-la para um grupo do IAM:
```
ALTER ROLE existing_database_role 
   IDENTIFIED GLOBALLY AS 'IAM_GROUP_NAME=IAM_Group_Name';
```

Se você quiser adicionar mais mapeamentos de atribuição global para outros grupos do serviço IAM, siga estas etapas para cada grupo do IAM.

Criar Senha do Banco de Dados do Serviço IAM para Usuários do IAM

Para adicionar um usuário do IAM e permitir que o usuário do IAM faça log-in no Autonomous Database fornecendo um nome de usuário e uma senha, você deve criar uma senha de banco de dados do IAM.

Consulte Como Trabalhar com Senhas do Banco de Dados do Serviço IAM para obter mais informações.

Estabelecer conexão com o Autonomous Database com Autenticação do IAM (Identity and Access Management)

Depois que o usuário ADMIN do banco de dados mapeia usuários globais e atribuições globais para os usuários e grupos do IAM, os usuários fazem log-in na instância do Autonomous Database usando suas credenciais do Oracle Cloud Infrastructure IAM ou acessam o banco de dados por meio de um token de banco de dados do Oracle Cloud Infrastructure.

Você ainda pode fazer log-in no Autonomous Database usando o nome de usuário e a senha da sua conta de banco de dados local (conta de usuário de banco de dados não global).

Você pode usar um cliente de banco de dados para acessar uma instância do Autonomous Database como um usuário do Oracle Cloud Infrastructure IAM. Para usar um cliente com credenciais de nome de usuário e senha do Oracle Cloud Infrastructure IAM e um verificador de senha, o cliente do banco de dados deve ser 12c ou mais recente.

Como alternativa, você pode usar um token de banco de dados do Oracle Cloud Infrastructure IAM para acessar uma instância do Autonomous Database com clientes compatíveis:

O JDBC-Thin com suporte para Autenticação de Token do IAM é suportado com:
- JDBC versão 19.13.0.0.1 (ou posterior): Consulte JDBC and UCP Downloads para obter drivers JDBC.
- JDBC versão 21.4.0.0.1 (ou posterior): Consulte Downloads de JDBC e UCP para obter drivers JDBC.
Consulte Suporte para Autenticação Baseada em Token do IAM para obter mais informações:
SQL*Plus e Oracle Instant Client: Compatíveis com SQL*Plus e Instant Client no Linux versões 19.13 ou mais recentes e Instant Client no Linux versões 21.4 ou mais recentes.
Consulte Autenticação Baseada em Token do IAM (Identity and Access Management) para obter mais informações.
O cliente do banco de dados também pode ser configurado para recuperar um token de banco de dados usando o nome de usuário do IAM e a senha do banco de dados do IAM.

Consulte Conexões do Cliente que Usam um Token Solicitado por um Nome de Usuário e uma Senha de Banco de Dados do IAM para obter mais informações.
Clientes .NET (versão mais recente do Linux ou Windows). Os componentes de software .NET estão disponíveis para download gratuito nos seguintes sites:

Observação:

Se sua instância do Autonomous Database estiver no Modo Restrito, somente os usuários com o privilégio RESTRICTED SESSION, como ADMIN, poderão se conectar ao banco de dados.

Sobre a Conexão com uma Instância do Autonomous Database on Dedicated Exadata Infrastructure Usando o IAM

Os usuários do serviço IAM podem se conectar à instância do Autonomous Database on Dedicated Exadata Infrastructure usando um verificador de senha de banco de dados do IAM ou um token do IAM.

O uso do verificador de senha do banco de dados do IAM é semelhante ao processo de autenticação de senha do Oracle Database. No entanto, em vez de o verificador de senha (hash criptografado da senha) ser armazenado no Autonomous Database on Dedicated Exadata Infrastructure, ele é armazenado como parte do perfil de usuário do Oracle Cloud Infrastructure (OCI) IAM.

O segundo método de conexão, o uso de um token do serviço IAM para o banco de dados, é mais moderno. O uso do acesso baseado em token é melhor para recursos de Nuvem, como o Autonomous Database on Dedicated Exadata Infrastructure. O token se baseia na força que o ponto final do IAM pode impor. Isso pode ser autenticação multifator, que é mais forte do que o uso exclusivo de senhas. Outro benefício do uso de tokens é que o verificador de senha (que é considerado confidencial) nunca fica armazenado ou disponível na memória.

Conexões de Cliente que Usam um Verificador de Senha do Banco de Dados do IAM

Depois de configurar a autorização necessária para o usuário do IAM, esse usuário poderá fazer log-in usando o aplicativo cliente existente, como SQL*Plus ou SQLcl, sem configuração adicional.

O usuário do IAM informa o nome de usuário e a senha do banco de dados do IAM (não a senha da console do Oracle Cloud Infrastructure [OCI]) usando qualquer cliente de banco de dados suportado no momento. A única restrição é que a versão do cliente de banco de dados seja a do Oracle Database release 12.1.0.2 ou mais recente para usar as senhas do Oracle Database 12c. O cliente do banco de dados deve poder usar o verificador de senha 12C. O uso da criptografia do verificador 11G não é suportado com o IAM. Nenhuma configuração especial de cliente ou ferramenta é necessária para que o usuário do IAM se conecte à instância do Autonomous Database on Dedicated Exadata Infrastructure.

Conexões de Cliente que Usam um Token

Para acesso de token do IAM ao Autonomous Database on Dedicated Exadata Infrastructure, o aplicativo cliente ou a ferramenta solicita um token de banco de dados do serviço IAM para o usuário do IAM.

O aplicativo cliente passará o token do banco de dados diretamente para o cliente do banco de dados por meio da API do cliente do banco de dados.

Se o aplicativo ou a ferramenta não tiverem sido atualizados para solicitar um token do IAM, o usuário do IAM poderá usar a CLI (interface de linha de comando) do Oracle Cloud Infrastructure (OCI) para solicitar e armazenar o token do banco de dados. Você pode solicitar um token de acesso (db-token) ao banco de dados usando as seguintes credenciais:

Tokens de segurança (com autenticação do IAM), tokens de delegação (no cloud shell do OCI) e API-keys, que são credenciais que representam o usuário do IAM para ativar a autenticação
Tokens de controlador de instâncias, que permitem que as instâncias sejam atores (ou entidades) autorizados a executar ações nos recursos de serviço após a autenticação
Token de controlador de recursos, que é uma credencial que permite que o aplicativo se autentique em outros serviços do Oracle Cloud Infrastructure

Quando os usuários do IAM fazem log-in no cliente com um log-in de barra / e o parâmetro OCI_IAM é configurado (sqlnet.ora, tnsnames.ora ou como parte de uma string de conexão), o cliente do banco de dados recupera o token do banco de dados de um arquivo. Se o usuário do IAM enviar um nome de usuário e uma senha, a conexão usará o acesso do verificador de banco de dados do IAM descrito para conexões de cliente que usam verificadores de senha de banco de dados do IAM. As instruções deste guia mostram como usar a CLI do OCI como auxiliar para o token de banco de dados. Se o aplicativo ou a ferramenta tiverem sido atualizados para trabalhar com o IAM, siga as instruções do aplicativo ou da ferramenta. Alguns casos de uso comuns incluem o seguinte: SQL*Plus no local, SQLcl no local, SQL*Plus no Cloud Shell ou aplicativos que usam wallets SEP.

Os seguintes tópicos explicam como:

Configurar uma conexão de cliente para o SQL*Plus para usar uma senha do banco de dados do IAM.
Configure uma conexão de cliente para o SQL*Plus que use um token do serviço IAM.
Acesse o banco de dados por meio de um token de banco de dados do Oracle Cloud Infrastructure IAM usando um controlador de instâncias.

Configurando uma Conexão de Cliente para o SQL*Plus que Usa uma Senha do Banco de Dados do IAM

Você pode configurar o SQL*Plus para usar uma senha do banco de dados do IAM.

Como usuário do IAM, faça log-in na instância do Autonomous Database usando a seguinte sintaxe:
```
CONNECT user_name@db_connect_string
Enter password: password
```
Nesta especificação, user_name é o nome de usuário do IAM. Há um limite de 128 bytes para a combinação domain_name/user_name.

O exemplo a seguir mostra como o usuário do IAM peter_fitch pode fazer log-in em uma instância do Autonomous Database.
```
sqlplus /nolog
connect peter_fitch@db_connect_string
Enter password: password
```
Alguns caracteres especiais exigirão aspas duplas em torno de user_name e password. Por exemplo:
```
"peter_fitch@example.com"@db_connect_string

"IAM database password"
```

Configurando uma Conexão do Cliente para o SQL*Plus que Usa um Token do Serviço IAM

Você pode configurar uma conexão de cliente para o SQL*Plus que usa um token do serviço IAM.

Certifique-se de ter uma conta de usuário do serviço IAM.
Verifique com um administrador do IAM e do Oracle Database se você tem uma política que permite acessar o banco de dados no compartimento ou na tenancy e se você está mapeado para um esquema global no banco de dados.
Se seu aplicativo ou ferramenta não oferecer suporte à integração direta do serviço IAM, faça download, instale e configure a CLI do OCI. Consulte Início Rápido da Interface de Linha de Comando do OCI. Configure uma chave de API como parte da configuração da CLI do OCI e selecione valores padrão.
1. Configure o acesso de chave da API para o usuário do serviço IAM.
2. Recupere o db-token. Por exemplo:
  - Recuperando um db-token com uma API-key usando a interface da linha de comando do OCI (Oracle Cloud Infrastructure):
```
oci iam db-token get
```
  - Recuperando um db-token com um token de segurança (ou sessão):
```
oci iam db-token get --auth security_token
```
    Se o token de segurança tiver expirado, será exibida uma janela para que o usuário possa fazer log-in no OCI novamente. Isso gerará o token de segurança para o usuário. A CLI do OCI usará esse token atualizado para obter o db-token.
  - Recuperando um db-token com um token de delegação: Quando você faz log-in no cloud shell, o token de delegação é gerado automaticamente e colocado no diretório /etc. Para obter esse token, execute o seguinte comando no cloud shell:
```
oci iam db-token get
```
  - Recuperando um token de instância usando a interface de linha de comando do OCI:
```
oci iam db-token get --auth instance_principal
```
3. O cliente do banco de dados também pode ser configurado para recuperar um token de banco de dados usando o nome de usuário do IAM e a senha do banco de dados do IAM.
  
  Consulte Conexões do Cliente que Usam um Token Solicitado por um Nome de Usuário e uma Senha de Banco de Dados do IAM para obter mais informações.
Consulte Chave e OCIDs Necessários para obter mais informações.
Certifique-se de estar usando as atualizações de versão mais recentes para o cliente Oracle Database versões 19c e 21c.
Essa configuração só funciona com o cliente Oracle Database versão 19c ou 21c.
Siga o processo existente para fazer download da wallet no Autonomous Database e siga as instruções para configurá-la para uso com o SQL*Plus.
1. Confirme se a correspondência de DN está ativada procurando SSL_SERVER_DN_MATCH=ON no arquivo sqlnet.ora.
2. Configure o cliente de banco de dados para usar o token do serviço IAM adicionando TOKEN_AUTH=OCI_TOKEN ao arquivo sqlnet.ora. Como você usará os locais padrão para o arquivo de token do banco de dados, não será necessário incluir o local do token.
Os valores TOKEN_AUTH e TOKEN_LOCATION nas strings de conexão tnsnames.ora têm precedência sobre as definições sqlnet.ora dessa conexão. Por exemplo, para a string de conexão, supondo que o token esteja no local padrão (~/.oci/db-token para Linux):
```
(description= 
  (retry_count=20)(retry_delay=3)
  (address=(protocol=tcps)(port=1522)
  (host=example.us-phoenix-1.oraclecloud.com))
  (connect_data=(service_name=aaabbbccc_exampledb_high.example.oraclecloud.com))
  (security=(ssl_server_cert_dn="CN=example.uscom-east-1.oraclecloud.com, 
     OU=Oracle BMCS US, O=Example Corporation, 
     L=Redwood City, ST=California, C=US")
  (TOKEN_AUTH=OCI_TOKEN)))
```

Depois que a string de conexão for atualizada com o parâmetro TOKEN_AUTH, o usuário do serviço IAM poderá fazer log-in na instância do Autonomous Database executando o comando a seguir para iniciar o SQL*Plus. Você pode incluir o próprio descritor de conexão ou usar o nome do descritor do arquivo tnsnames.ora.

connect /@exampledb_high

Ou:

connect /@(description= 
  (retry_count=20)(retry_delay=3)
  (address=(protocol=tcps)(port=1522)
  (host=example.us-phoenix-1.oraclecloud.com))
  (connect_data=(service_name=aaabbbccc_exampledb_high.example.oraclecloud.com))
  (security=(ssl_server_cert_dn="CN=example.uscom-east-1.oraclecloud.com, 
     OU=Oracle BMCS US, O=Example Corporation, 
     L=Redwood City, ST=California, C=US")
  (TOKEN_AUTH=OCI_TOKEN)))

O cliente de banco de dados já está configurado para obter um db-token porque o parâmetro TOKEN_AUTH já foi definido, por meio do arquivo sqlnet.ora ou em uma string de conexão. O cliente de banco de dados obtém o db-token e o assina usando a chave privada e, em seguida, envia o token ao Autonomous Database. Se um nome de usuário do IAM e uma senha de banco de dados do IAM forem especificados, em vez de uma barra /, o cliente de banco de dados estabelecerá conexão usando a senha, em vez de usar db-token.

Usar o Controlador de Instâncias para Acessar o Autonomous Database com a Autenticação do IAM (Identity and Access Management)

Depois que o usuário ADMIN ativar o Oracle Cloud Infrastructure IAM no Autonomous Database, um aplicativo poderá acessar o banco de dados por meio de um token de banco de dados do Oracle Cloud Infrastructure IAM usando um controlador de instâncias.

Consulte Acessando a API do Oracle Cloud Infrastructure com Controladores de Instâncias para obter mais informações.

Configurar Autenticação de Proxy

A autenticação de proxy permite que um usuário do IAM faça proxy em um esquema para tarefas como manutenção de aplicativos.

A autenticação de proxy geralmente é usada para autenticar o usuário real e, em seguida, autorizá-lo a usar um esquema com os privilégios e atribuições do esquema para gerenciar um aplicativo. Alternativas como o compartilhamento da senha do esquema do aplicativo são consideradas perigosas e não podem verificar qual usuário real executou uma ação.

Um caso de uso pode estar em um ambiente no qual um usuário do IAM designado que é um administrador de banco de dados de aplicativo pode se autenticar usando suas credenciais e, em seguida, fazer proxy para um usuário de esquema (por exemplo, hrapp). Essa autenticação permite que o administrador do IAM use os privilégios e atribuições hrapp como usuário hrapp para executar a manutenção do aplicativo e ainda use suas credenciais do IAM para autenticação. Um administrador de banco de dados de aplicativo pode acessar o banco de dados e, em seguida, fazer proxy em um esquema de aplicativo para gerenciar esse esquema.

Você pode configurar a autenticação de proxy para os métodos de autenticação de senha e de token.

Configurando a Autenticação de Proxy para o Usuário do IAM

Para configurar a autenticação de proxy para um usuário do IAM, o usuário do IAM já deve ter um mapeamento para um esquema global (mapeamento exclusivo ou compartilhado). Um esquema separado para o usuário do IAM para proxy também deve estar disponível.

Depois de garantir que você tenha esse tipo de usuário, altere o usuário do banco de dados para permitir que o usuário do IAM faça proxy dele.

Faça log-in na instância do Autonomous Database como um usuário que tenha privilégios de sistema ALTER USER.
Conceda permissão para que o usuário do IAM faça proxy para a conta de usuário do banco de dados local. Um usuário do IAM não pode ser referenciado no comando para que o proxy seja criado entre o usuário global do banco de dados (mapeado para o usuário do IAM) e o usuário do banco de dados de destino. No exemplo a seguir, hrapp é o esquema para o proxy e peterfitch_schema é o usuário global do banco de dados mapeado exclusivamente para o usuário peterfitch.
```
ALTER USER hrapp GRANT CONNECT THROUGH peterfitch_schema;
```

Nesse estágio, o usuário do IAM pode fazer log-in na instância do banco de dados usando o proxy. Por exemplo:

Para estabelecer conexão usando um verificador de senha:

CONNECT peterfitch[hrapp]@connect_string
Enter password: password

Para estabelecer conexão usando um token:

CONNECT [hrapp]/@connect_string

Validando a Autenticação de Proxy do Usuário do IAM

Você pode validar a configuração de proxy do usuário do IAM para métodos de autenticação de senha e token.

Faça log-in na instância do Autonomous Database como um usuário que tenha os privilégios de sistema CREATE USER e ALTER USER.

Conecte-se como usuário do IAM e execute os comandos SHOW USER e SELECT SYS_CONTEXT. Por exemplo, suponha que você queira verificar a autenticação de proxy do usuário do IAM peterfitch quando ele fizer proxy para o usuário do banco de dados hrapp. Você precisará estabelecer conexão com o banco de dados usando os diferentes tipos de métodos de autenticação mostrados aqui, mas a saída dos comandos que você executar será a mesma para todos os tipos.

Para autenticação baseada em senha:

CONNECT peterfitch[hrapp]/password\!@connect_string
SHOW USER;
--The output should be USER is "HRAPP"
SELECT SYS_CONTEXT('USERENV','AUTHENTICATION_METHOD') FROM DUAL;
--The output should be "PASSWORD_GLOBAL"
SELECT SYS_CONTEXT('USERENV','PROXY_USER') FROM DUAL;
--The output should be "PETERFITCH_SCHEMA"
SELECT SYS_CONTEXT('USERENV','CURRENT_USER') FROM DUAL;
--The output should be "HRAPP"

Para autenticação baseada em token:

CONNECT [hrapp]/@connect_string
SHOW USER;
--The output should be USER is "HRAPP "
SELECT SYS_CONTEXT('USERENV','AUTHENTICATION_METHOD') FROM DUAL;
--The output should be "TOKEN_GLOBAL"
SELECT SYS_CONTEXT('USERENV','PROXY_USER') FROM DUAL;
--The output should be "PETERFITCH_SCHEMA"
SELECT SYS_CONTEXT('USERENV','CURRENT_USER') FROM DUAL;
--The output should be "HRAPP"

Usar um Link de Banco de Dados com Usuários Autenticados do Serviço IAM

Você pode usar um link de banco de dados para estabelecer conexão de uma instância do Autonomous Database com outra como um usuário do Oracle Cloud Infrastructure IAM.

Você pode usar o link de banco de dados de usuário conectado ou fixo para estabelecer conexão com um Autonomous Database como um usuário do IOracle Cloud Infrastructure IAM.

Observação:

Não há suporte para o link de banco de dados do usuário atual para estabelecer conexão com um Autonomous Database como um usuário do Oracle Cloud Infrastructure IAM.

Link de Banco de Dados de Usuário Conectado: Para um link de banco de dados de usuário conectado, um usuário do serviço IAM deve ser mapeado para um esquema nos bancos de dados de origem e de destino conectados por um link de banco de dados. Você pode usar um verificador de senha do banco de dados ou um token de banco de dados do serviço IAM para usar um link de banco de dados do usuário conectado.
Link de Banco de Dados de Usuário Fixo: Um link de banco de dados de usuário fixo pode ser criado usando um usuário do banco de dados ou um usuário do serviço IAM. Ao usar um usuário do serviço IAM como um link de banco de dados de usuário fixo, o usuário do serviço IAM deve ter um mapeamento de esquema no banco de dados de destino. O usuário do serviço IAM para um link de banco de dados só pode ser configurado com um verificador de senha.

Desativar a Autenticação do IAM (Identity and Access Management) no Autonomous Database

Descreve as etapas para desativar o acesso do usuário de autenticação externa do IAM para o Autonomous Database.

Você pode desativar o acesso do usuário do serviço IAM na sua instância do Autonomous Database usando o comando ALTER SYSTEM, conforme mostrado abaixo:

ALTER SYSTEM RESET IDENTITY_PROVIDER_TYPE SCOPE=BOTH;

Se você também quiser atualizar o acesso ao serviço IAM do recurso, ou seja, Autonomous Container Database ou Autonomous Database, talvez seja necessário remover ou modificar o grupo do serviço IAM e as políticas configuradas para permitir o acesso ao serviço IAM desses recursos.

Observações para Usar as Ferramentas do Autonomous Database com Autenticação do Serviço IAM (Identity and Access Management)

Fornece observações para usar as ferramentas do Autonomous Database com a autenticação do IAM ativada.

O Oracle APEX não oferece suporte a usuários do IAM com o Autonomous Database. Consulte Acessar Serviços de Administração do Oracle Application Express para obter informações sobre o uso de usuários regulares do banco de dados com o Autonomous Database.
O Database Actions não oferece suporte a usuários do IAM com o Autonomous Database. Consulte Ativando o Acesso do Usuário ao Database Actions para obter informações sobre como usar usuários regulares do banco de dados com o Autonomous Database.