Configurando o Acesso aos Dados de um Domínio IoT

A configuração do acesso à sua view de dados é opcional e depende de qual sistema você deseja usar para consumir seus dados IoT.

Dependendo de onde você deseja exibir seus dados IoT como parte da configuração de cada sistema, você deve configurar a autenticação para o domínio IoT para acessar o sistema específico ao qual deseja se conectar.

Ao criar um domínio, você pode especificar as opções de acesso a dados. Após a criação de um domínio, você pode alterar as opções para autenticar uma conexão para acessar seus dados.
1. Na página de lista domínios, selecione o domínio com o qual você deseja trabalhar. Se precisar de ajuda para localizar a página de lista ou um domínio IoT, consulte Listando Domínios IoT.
2. Para exibir quais opções de autenticação estão configuradas para este domínio IoT, selecione a guia acesso a dados.
  Dependendo do tipo de conexão de dados configurado para o domínio, exiba os detalhes de autenticação do grupo de domínios IoT. Por exemplo, se você vir Nomes de grupo de identidades, o domínio IoT será configurado para autenticação para exibir dados IoT usando ORDS.
3. Para atualizar qual opção o domínio IoT usa para exibir os dados do IoT, selecione o menu Ações e, em seguida, selecione Alterar Acesso aos Dados.
4. Selecione qualquer Tipo de acesso para inserir os detalhes de autenticação para exibir dados para este domínio IoT em qualquer um dos seguintes sistemas:
  
  acesso direto a dados: Se quiser estabelecer uma conexão direta com o banco de dados para exibir dados no banco de dados, você deverá criar um grupo dinâmico de Identidades. Ou, se quiser estabelecer conexão com o Analytics Cloud, configure criar um usuário do domínio de Identidades. Depois disso, informe o(s) grupo(s) de Identidades do IAM com permissão para estabelecer conexão com o banco de dados.
  Se vários usuários do domínio de Identidades estiverem configurados, adicione vários grupos de Identidades para acessar dados desse domínio IoT, selecione Adicionar outro Grupo de Identidades.
  Informe qualquer uma das seguintes opções para o grupo de Identidades do IAM:
  
  Um <identity-group-name> é o grupo de usuários de Identidades ou um grupo dinâmico de Identidades.
  
  Se o <identity-group-name> estiver no domínio de Identidades padrão, use este formato:
  <tenancy-OCID:<identity-group-name>
  
  Se o <identity-group-name> não estiver no domínio de Identidades padrão, use este formato para especificar o nome do domínio de Identidades para o grupo de usuários do domínio de Identidades ou o grupo dinâmico de identidades:
  <tenancy-OCID:<identity-domain-name>/<identity-group-name>
  
  Acesso ao ORDS (Oracle REST Data Services): para configurar o acesso aos seus dados no ORDS, digite o Nome do host do domínio de identidades que está autorizado a estabelecer uma conexão com o host de dados usando o ORDS:
  idcs-<unique-id>.identity.oraclecloud.com
  
  Acesso ao Oracle Application Express (APEX): se você configurar o acesso aos seus dados no APEX, informe a senha inicial do APEX para o espaço de trabalho do APEX para o seu domínio IoT:
  <your-apex-initial-password>
  Observação
  
  A senha inicial do APEX deve ter pelo menos 12 caracteres.
5. Selecione Atualizar.
6. (Opcional) Para exibir a solicitação de serviço de uma atualização, vá para o domínio e selecione a guia solicitação de serviço.
  Selecione o nome da operação da solicitação de serviço para exibir o OCID.
  Selecione Messages para ver as mensagens de log, os erros de log e os recursos associados relacionados. Por exemplo, os recursos associados para grupos de domínios exibem os domínios relacionados.
  Para obter mais informações, consulte Obtendo Detalhes de uma Solicitação de Serviço para sua Internet of Things.
A configuração depende de qual sistema você deseja se conectar para exibir seus dados do IoT. As duas opções a seguir requerem o uso do comando oci iot domain configure-direct-data-access durante o processo de configuração:
- Para consultar seus dados do IoT diretamente no banco de dados, configure uma conexão direta com o banco de dados.
- Para se conectar ao Oracle Analytics Cloud, configure o acesso a dados para o Oracle Analytics Cloud.
Use o comando oci iot domain configure-direct-data-access e os parâmetros necessários para configurar a autenticação de um domínio IoT para estabelecer uma conexão direta com o banco de dados.

Substitua o <tenancy-OCID:<identity-group-name> pelos valores do seu ambiente. O <identity-group-name> pode se referir ao grupo de identidades de usuários ou ao grupo dinâmico de identidades.
- Para o parâmetro <identity-group-name>, você pode fazer referência ao grupo de identidades de usuários ou ao grupo dinâmico de identidades: <tenancy-OCID>:<identity-group-name>
- Se o <identity-domain-name> não estiver no domínio de Identidades padrão, especifique o <identity-domain-name>. Por exemplo:
  <tenancy-OCID>:<identity-domain-name>/<identity-group-name>
```
oci iot domain configure-direct-data-access --iot-domain-id <iot-domain-OCID> --db-allow-listed-identity-group-names '["<tenancy-OCID:<identity-domain-name>/<identity-group-name>"]'
```
Para visualizar seus dados no ORDS, é necessário configurar o acesso para visualizar seus dados IoT no ORDS. Esse processo de configuração usa o comando a seguir.

Use o comando oci iot domain configure-ORDS-data-access e os parâmetros necessários para configurar o acesso de um domínio IoT ao ORDS (Oracle REST Data Services):
```
oci iot domain configure-ords-data-access --iot-domain-id <iot-domain-OCID> --db-allowed-identity-domain-host <idcs-<unique-id>.identity.oraclecloud.com>
```
Para exibir seus dados no APEX, é necessário configurar o acesso para exibir seus dados IoT no APEX usando o comando a seguir.

Use o comando oci iot domain configure-apex-data-access e os parâmetros necessários para configurar o acesso de um domínio IoT ao Oracle Application Express (APEX):
```
oci iot domain configure-apex-data-access --iot-domain-id <iot-domain-OCID> --db-workspace-admin-initial-password "<your-apex-initial-password>"
```
Observação

A senha inicial do APEX deve ter pelo menos 12 caracteres.
Para obter uma lista completa de parâmetros e valores para comandos CLI, consulte Referência de Comando CLI.
Execute a operação ConfigureIotDomainDataAccess para autenticar um domínio IoT para estabelecer uma conexão direta com o banco de dados:
Se quiser consultar seus dados IoT diretamente no banco de dados, configure uma conexão direta com o banco de dados ou se quiser estabelecer conexão com o Oracle Analytics Cloud, configure uma conexão de banco de dados com o Oracle Analytics Cloud. Como parte do processo de configuração, você pode usar a API para adicionar o usuário ou grupo do domínio de Identidades a um domínio IoT configurado para estabelecer conexão com o banco de dados IoT, por exemplo:
POST /20250531/iotDomains/{iotDomainId}/actions/configureDataAccess { "type": "DIRECT", "dbAllowlistedIdentityGroupNames": ["<identity-group-name>",...] }
Para exibir seus dados no ORDS, é necessário configurar o acesso para exibir seus dados IoT no ORDS. Como parte do processo de configuração, você pode usar a API para adicionar o host do domínio de Identidades a um domínio IoT para estabelecer conexão com o ORDS (Oracle REST Data Services), por exemplo:
POST /20250531/iotDomains/{iotDomainId}/actions/configureDataAccess { "type": "ORDS", "dbAllowedIdentityDomainHost": "<idcs-<unique-id>.identity.oraclecloud.com>" }
Para exibir seus dados no APEX, é necessário configurar o acesso para exibir seus dados IoT no APEX. Como parte desse processo de configuração, você pode usar a API para configurar o APEX para o domínio IoT, por exemplo:
POST /20250531/iotDomains/{iotDomainId}/actions/configureDataAccess { "type": "APEX", "dbWorkspaceAdminInitialPassword": "<your-apex-initial-password>" }
Observação

A senha inicial do APEX deve ter pelo menos 12 caracteres.

Documentação do Oracle Cloud Infrastructure

Configurando o Acesso aos Dados de um Domínio IoT