Esta página foi traduzida pela API Cloud Translation.

Okta

Pode usar o conetor do Okta para criar, ler, atualizar e eliminar registos de utilizadores, grupos, funções e apps, bem como atribuir ou anular a atribuição de utilizadores ou grupos a funções e aplicações.

Antes de começar

No seu projeto do Google Cloud, faça as seguintes tarefas:

Certifique-se de que a conetividade de rede está configurada. Para obter informações sobre padrões de rede, consulte o artigo Conetividade de rede.
Conceda a função IAM roles/connectors.admin ao utilizador que está a configurar o conetor.
Conceda as funções de IAM roles/secretmanager.viewer e roles/secretmanager.secretAccessor à conta de serviço que quer usar para o conector.
Ative os seguintes serviços:
- secretmanager.googleapis.com (Secret Manager API)
- connectors.googleapis.com (API Connectors)
Para saber como ativar serviços, consulte o artigo Ativar serviços. Se estes serviços ou autorizações não tiverem sido ativados anteriormente para o seu projeto, é-lhe pedido que os ative quando configurar o conector.

Crie uma ligação do Okta

Uma associação é específica de uma origem de dados. Isto significa que, se tiver muitas origens de dados, tem de criar uma associação separada para cada origem de dados. Para criar uma associação, faça o seguinte:

Na Cloud Console, aceda à página Integration Connectors > Ligações e, de seguida, selecione ou crie um projeto do Google Cloud.
Aceda à página Ligações
Clique em + Criar novo para abrir a página Criar associação.
Na secção Localização, escolha a localização para a ligação.
1. Região: selecione uma localização na lista pendente.
  Para ver a lista de todas as regiões suportadas, consulte o artigo Localizações.
2. Clicar em Seguinte.
Na secção Detalhes da associação, conclua o seguinte:
1. Selecione Okta na lista Conetor.
2. Selecione uma versão do conetor na lista Versão do conetor.
3. No campo Nome da associação, introduza um nome para a instância da associação. O nome da associação pode conter letras minúsculas, números ou hífenes. O nome tem de começar com uma letra e terminar com uma letra ou um número, e não pode exceder os 49 carateres.
4. Opcionalmente, introduza uma Descrição para a instância de associação.
5. Opcionalmente, ative o Registo na nuvem e, em seguida, selecione um nível de registo. Por predefinição, o nível do registo está definido como Error.
6. Conta de serviço: selecione uma conta de serviço que tenha as funções necessárias.
7. Domínio: introduza um domínio do Okta para estabelecer ligação à instância do Okta.
8. Opcionalmente, clique em + Adicionar etiqueta para adicionar uma etiqueta à associação sob a forma de um par chave/valor.
9. Clicar em Seguinte.
Na secção Autenticação, introduza os detalhes de autenticação.
1. Selecione um Tipo de autenticação e introduza os detalhes relevantes.
  Os seguintes tipos de autenticação são suportados pela ligação do Okta:
  - OAuth 2.0 – Código de autorização
  - Credenciais de cliente OAuth 2.0 com portador JWT
2. Clicar em Seguinte.
Rever: reveja os detalhes da ligação e da autenticação.
Clique em Criar.

Configure a autenticação

Introduza os detalhes com base na autenticação que quer usar.

OAuth 2.0 – Código de autorização
- ID de cliente: o ID de cliente usado para pedir tokens de acesso.
- Âmbitos: uma lista separada por vírgulas dos âmbitos pretendidos.
- Segredo do cliente: o segredo do cliente usado para pedir tokens de acesso.
- URL de autorização: o URL de autorização gerado quando cria o cliente.

Para o tipo de autenticação Authorization code, depois de criar a associação, tem de efetuar alguns passos adicionais para configurar a autenticação. Para mais informações, consulte Passos adicionais após a criação da associação.

OAuth 2.0 – Credenciais de cliente com portador JWT
- ID de cliente: o ID de cliente usado para pedir tokens de acesso.
- Âmbitos: uma lista separada por vírgulas dos âmbitos pretendidos.
- Chave privada: segredo do Secret Manager que contém o conteúdo do ficheiro de chave privada no formato PEM. A chave privada tem de corresponder à chave pública/certificado.

Passos adicionais após a criação da associação

Se selecionou OAuth 2.0 - Authorization code para a autenticação, tem de realizar os seguintes passos adicionais após criar a associação:

Na página Ligações, encontre a ligação criada recentemente.
Tenha em atenção que o Estado do novo conetor é Autorização necessária.
Clique em Autorização obrigatória.
É apresentado o painel Editar autorização.
Copie o valor do URI de redirecionamento para a sua aplicação externa.
Valide os detalhes da autorização.
Clique em Autorizar.
Se a autorização for bem-sucedida, o estado da ligação é definido como Ativo na página Ligações.

Nova autorização para o código de autorização

Se estiver a usar o tipo de autenticação Authorization code e tiver feito alterações à configuração, tem de autorizar novamente a ligação do Okta. Para autorizar novamente uma associação, siga estes passos:

Clique na associação necessária na página Associações.
É apresentada a página de detalhes da associação.
Clique em Editar para editar os detalhes da associação.
Valide os detalhes de OAuth 2.0 – Código de autorização na secção Autenticação.
Se necessário, faça as alterações necessárias.
Clique em Guardar. Esta ação direciona para a página de detalhes da associação.
Clique em Editar autorização na secção Autenticação. É apresentado o painel Autorizar.
Clique em Autorizar.
Se a autorização for bem-sucedida, o estado da ligação é definido como Ativo na página Ligações.

Limitações do sistema

O conector do Okta pode processar um máximo de uma transação por segundo, por nó e limita todas as transações que excedam este limite. Por predefinição, os Integration Connectors atribuem 2 nós (para uma melhor disponibilidade) a uma ligação.

Para informações sobre os limites aplicáveis aos Integration Connectors, consulte Limites.

Nota: o número de nós de conectores de integração é dimensionado automaticamente de forma dinâmica com base na sua utilização. No entanto, se quiser reservar capacidade para grandes volumes sem esperar pela escalabilidade automática, pode ajustar o valor mínimo de nós para uma ligação. São necessários mais nós para processar mais transações para uma associação. Por outro lado, são necessários menos nós se uma associação processar menos transações. Para configurar os valores dos nós, faça o seguinte:

Se for cliente de pagamento conforme o uso, configure o valor mínimo e máximo do nó na página de edição da associação.
Se for cliente com base numa subscrição, contacte o apoio técnico.

O número máximo de transações que um nó pode processar depende de vários fatores. Assim, antes de ajustar os nós mínimos para um melhor débito, é recomendável verificar se os seus sistemas de back-end estão configurados de forma ideal para processar o tráfego necessário.

Use a associação do Okta numa integração

Depois de criar a ligação, esta fica disponível no Apigee Integration e no Application Integration. Pode usar a ligação numa integração através da tarefa Conectores.

Para compreender como criar e usar a tarefa Connectors no Apigee Integration, consulte o artigo Tarefa Connectors.
Para compreender como criar e usar a tarefa Connectors na integração de aplicações, consulte o artigo Tarefa Connectors.

Ações

Esta secção apresenta as ações suportadas pelo conetor do Okta. Para compreender como configurar as ações, consulte os exemplos de ações.

Ação ReactivateUser

Esta ação reativa um utilizador.

Parâmetros de entrada da ação ReactivateUser

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
UserID	String	True	O ID do utilizador.

Por exemplo, para saber como configurar a ação ReactivateUser, consulte o exemplo ActivateUser.

Ação ActivateUser

Esta ação ativa um utilizador.

Introduza os parâmetros da ação ActivateUser

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
UserID	String	True	O ID do utilizador.

Por exemplo, para saber como configurar a ação ActivateUser, consulte o exemplo ActivateUser.

Ação DeactivateUser

Esta ação desativa um utilizador.

Introduza os parâmetros da ação DeactivateUser

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
UserID	String	True	O ID do utilizador.

Por exemplo, para saber como configurar a ação DeactivateUser, consulte o exemplo de desativação do utilizador.

Ação Assignusertogroup

Esta ação atribui um utilizador a um grupo.

Parâmetros de entrada da ação Assignusertogroup

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
UserID	String	True	O ID do utilizador.
GroupID	String	True	O ID do grupo.

Por exemplo, para saber como configurar a ação Assignusertogroup, consulte o exemplo Assignusertogroup.

Ação UnassignUsertoRole

Esta ação remove a atribuição de um utilizador a uma função.

Parâmetros de entrada da ação UnassignUsertoRole

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
UserID	String	True	O ID do utilizador.
RoleAssignmentId	String	True	O ID da função.

Por exemplo, para saber como configurar a ação UnassignUsertoRole, consulte o exemplo de anulação da atribuição do utilizador à função.

Ação AssignUsertoRole

Esta ação atribui um utilizador a uma função.

Parâmetros de entrada da ação AssignUsertoRole

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
UserID	String	True	O ID do utilizador.
RoleId	String	True	O ID da função.

Por exemplo, para saber como configurar a ação AssignUsertoRole, consulte o exemplo AssignUsertoRole.

AssignUsertoApp action

Esta ação atribui um utilizador a uma app.

Parâmetros de entrada da ação AssignUsertoApp

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
UserID	String	True	O ID do utilizador.
AppId	String	True	O ID da app.

Por exemplo, para saber como configurar a ação AssignUsertoApp, consulte o exemplo AssignUsertoApp.

Ação UnassignUsertoGroup

Esta ação anula a atribuição de um utilizador a um grupo.

Parâmetros de entrada da ação UnassignUsertoGroup

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
UserID	String	True	O ID do utilizador.
GroupID	String	True	O ID do grupo.

Por exemplo, para saber como configurar a ação UnassignUsertoGroup, consulte o exemplo UnassignUsertoGroup.

UnassignUsertoApp action

Esta ação desatribui um utilizador de uma app.

Parâmetros de entrada da ação UnassignUsertoApp

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
UserID	String	True	O ID do utilizador.
AppID	String	True	O ID da app.

Por exemplo, para saber como configurar a ação UnassignUsertoApp, consulte o exemplo UnassignUsertoApp.

Ação Assigngrouptoapp

Esta ação atribui um grupo a uma app.

Parâmetros de entrada da ação Assigngrouptoapp

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
GroupId	String	True	O ID do grupo.
AppID	String	True	O ID da app.

Por exemplo, para saber como configurar a ação Assigngrouptoapp, consulte o exemplo Assigngrouptoapp.

Ação AssignGrouptoRole

Esta ação atribui um grupo a uma função.

Parâmetros de entrada da ação AssignGrouptoRole

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
GroupId	String	True	O ID do grupo
RoleId	String	True	O ID da função
TypeId	String	True	O ID do tipo

Por exemplo, para saber como configurar a ação AssignGrouptoRole, consulte o exemplo AssignGrouptoRole.

Ação UnassignGrouptoApp

Esta ação desatribui um grupo de uma app.

Introduza os parâmetros da ação UnassignGrouptoApp

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
Grupo	String	True	O ID de GroupId
AppID	String	True	O ID da app

Por exemplo, para saber como configurar a ação UnassignGrouptoApp, consulte o UnassignGrouptoApp Example.

Ação UnassignGrouptoRole

Esta ação desatribui um grupo de uma função.

Parâmetros de entrada da ação UnassignGrouptoRole

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
Grupo	String	True	O ID de GroupId
AppID	String	True	O ID do AppId

Por exemplo, para saber como configurar a ação UnassignGrouptoRole, consulte o exemplo UnassignGrouptoRole.

Ação SuspendUser

Esta ação suspende um utilizador.

Introduza os parâmetros da ação SuspendUser

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
Grupo	String	True	O ID de GroupId.
AppID	String	True	O ID do AppId.

Por exemplo, para saber como configurar a ação SuspendUser, consulte o exemplo de suspensão de utilizadores.

Ação UnsuspendUser

Esta ação anula a suspensão de um utilizador.

Introduza os parâmetros da ação UnsuspendUser

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
Grupo	String	True	O ID de GroupId.
AppID	String	True	O ID do AppId.

Por exemplo, para saber como configurar a ação UnsuspendUser, consulte o exemplo de anulação da suspensão do utilizador.

Exemplos de ações

Exemplo: reative um utilizador

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação ReactivateUser e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
{
    "UserId": "00ulgqf2s4Zs5Ohge5d7"
}
```

Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:ReactivateUserconnectorOutputPayload

{ 
    "Status": "Success",
    "ActivationToken": "PKeQTJMUW9vg0wyh8czA",
    "ActivationUrl": "https://dev-99779501.okta.com/tokens/PKeQTJMUW9vg0wyh8czA/verify" 
}

Exemplo: ative um utilizador

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação ActivateUser e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
{
    "UserId": "00ulgqf2s4Zs5Ohge5d7"
}
```

Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:ActivateUserconnectorOutputPayload

{ 
  "Status": "Success",
    "activationurl": null,
    "activationtoken": null
}

Exemplo: desative um utilizador

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação DeactivateUser e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
{
    "UserId": "00ulgqf2s4Zs5Ohge5d7"
}
```

Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:DeactivateUserconnectorOutputPayload

{ 
 "Status": "Success",
"activationurl": null,
"activationtoken": null 
}

Exemplo: atribua um utilizador a um grupo

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação Assignusertogroup e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
{
    "UserId": "00ulgqf2s4Zs5Ohge5d7",
    "GroupId": "7463874b834938475d"
}
```

Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:AssignusertogroupconnectorOutputPayload

{
 "Status": "Success",
}

Exemplo: remova um utilizador de uma função

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação UnassignUsertoRole e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
{
    "UserId": "00ukxucmpl25SNLP65d7",
    "RoleAssignmentId": "irblawnjpom1bLBcJ5d7"
}
```

Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:UnassignUsertoRoleconnectorOutputPayload

{
 "Status": "Success",
}

Exemplo: atribua um utilizador a uma função

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação AssignUsertoRole e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
{
"UserId": "00ukxucmpl25SNLP65d7",
"RoleId": "cr0l2n9ay0pCCxLgG5d7",
"ResourceSet": "iaml81kep6zefR4Oq5d7",
"Type": "CUSTOM"
}
```

Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:AssignUsertoRoleconnectorOutputPayload

{
 "Status": "Success",
    "Id": "irblawfe99RsUfILD5d7",
    "Label": "UserCreatorByabhishkePostman",
    "Type": "CUSTOM", 
    "Created": "2024-11-21 07:33:05.0",
    "LastUpdated": "2024-11-21 07:33:05.0",
    "AssignmentStatus": "ACTIVE",
    "AssignmentType": "USER",
    "resource-set": "iaml81kep6zefR4Oq5d7",
    "role": "cr0l2n9ay0pCCxLgG5d7",
    "_links_role_href": "https://dev-99779501-admin.okta.com/api/v1/iam/roles/cr0l2n9ay0pCCxLgG5d7",
    "_links_resource-set_href": "https://dev-99779501.okta.com/api/v1/iam/resource-sets/iaml81kep6zefR4Oq5d7",
    "_links_permissions_href": "https://dev-99779501-admin.okta.com/api/v1/iam/roles/cr0l2n9ay0pCCxLgG5d7/permissions",
    "_links_member_href": "https://dev-99779501.okta.com/api/v1/iam/resource-sets/iaml81kep6zefR4Oq5d7/bindings/cr0l2n9ay0pCCxLgG5d7/members/irblawfe99RsUfILD5d7",
    "_links_assignee_href": "https://dev-99779501.okta.com/api/v1/users/00ukxucmpl25SNLP65d7"

}

Exemplo: atribua um utilizador a uma app

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação AssignUsertoApp e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
{
    "UserId": "00ukxucmpl25SNLP65d7",
    "AppId": "0oakn3j0bfGPR1Esk5d7"
}
```

Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:AssignUsertoAppconnectorOutputPayload

{
    "Status": "Success",
    "Id": "00ukxucmpl25SNLP65d7",
    "Created": "2024-11-21 07:08:40.0",
    "LastUpdated": "2024-11-21 07:08:45.0",
    "Scope": "USER",
    "AssignmentStatus": "ACTIVE",
    "externalid": null, 
    "statuschanged": "2024-11-21T07:08:40.000Z",
    "passwordchanged": null,
    "syncstate": "DISABLED",
    "credentials_username": "baklavainthebalkans@gmail.com",
    "profile_street_address": null,
    "profile_country": null, 
    "profile_website": null,
    "profile_zoneinfo": "America/Los_Angeles",
    "profile_birthdate": null,
    "profile_gender": null,
    "profile_formatted": null,
    "profile_profile": null,
    "profile_locality": null,
    "profile_given_name": "Baklavainthe",
    "profile_middle_name": null,
    le_phone_number": null,
    "profile_region": null,
    "profile_postal_code": null,
    "profile_family_name": "Balkans",
    "profile_email": "baklavainthebalkans@gmail.com",
    "_links_app_href": "https://dev-99779501.okta.com/api/v1/apps/0oakn3j0bfGPR1Esk5d7", 
    "_links_user_href": "https://dev-99779501.okta.com/api/v1/users/00ukxucmpl25SNLP65d7"

}

Exemplo: anule a atribuição de um utilizador a um grupo

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação UnassignUsertoGroup e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
{
    "UserId": "00ukxucmpl25SNLP65d7",
    "GroupId": "0oakn3j0bfGPR1Esk5d7"
}
```

Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:UnassignUsertoGroupconnectorOutputPayload

{
"Status": "Success"
}

Exemplo: remova a atribuição de um utilizador a uma app

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação UnassignUsertoApp e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
{
    "UserId": "00ukxucmpl25SNLP65d7",
    "AppId": "0oakn3j0bfGPR1Esk5d7"
}
```

Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:UnassignUsertoAppconnectorOutputPayload

 
{
"Status": "Success"
}

Exemplo: atribua um grupo a uma app

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação Assigngrouptoapp e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
{
   "GroupId": "00gl5wovm8GuLr8vg5d7",
    "AppId": "0oakn3j0bfGPR1Esk5d7"
}
```

Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:AssigngrouptoappconnectorOutputPayload

{
"Status": "Success",
"Id": "00gl5wovm8GuLr8vg5d7",
"LastUpdated": "2024-11-21 08:42:53.0",
"Priority": 0,
"_links_app_href": "https://dev-99779501.okta.com/api/v1/apps/0oakn3j0bfGPR1Esk5d7",
"_links_self_href": "https://dev-99779501.okta.com/api/v1/apps/0oakn3j0bfGPR1Esk5d7/groups/00gl5wovm8GuLr8vg5d7", "_links_group_href": "https://dev-99779501.okta.com/api/v1/groups/00gl5wovm8GuLr8vg5d7"
}

Exemplo: atribua um grupo a uma função

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação AssignGrouptoRole e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
{
"GroupId": "00gl9xqojqXq0TJgS5d7",
"RoleId": "cr0l5tqddvkDtcfPl5d7",
"Type": "CUSTOM", "ResourceSet": "iaml81kep6zefR4Oq5d7"
}
```

Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:AssignGrouptoRoleconnectorOutputPayload

{
"Status": "Success",
"Id": "irbla1k8uy8XxDDFF5d7",
"Label": "ReadAdmin_Altostrat",
"Type": "CUSTOM",
"Created": "2024-11-20 12:28:33.0",
"LastUpdated": "2024-11-20 12:28:33.0",
"AssignmentStatus": "ACTIVE",
"AssignmentType": "GROUP",
"resource-set": "iaml81kep6zefR4Oq5d7",
"role": "cr0l5tqddvkDtcfPl5d7",
"_links_role_href": "https://dev-99779501-admin.okta.com/api/v1/iam/roles/cr0l5tqddvkDtcfPl5d7",
"_links_resource-set_href": "https://dev-99779501.okta.com/api/v1/iam/resource-sets/iaml81kep6zefR4Oq5d7", "_links_permissions_href": "https://dev-99779501-admin.okta.com/api/v1/iam/roles/cr0l5tqddvkDtcfPl5d7/permissions", "_links_member_href": "https://dev-99779501.okta.com/api/v1/iam/resource-sets/iaml81kep6zefR4Oq5d7/bindings/cr0l5tqddvkDtcfPl5d7/members/irbla1k8uy8XxDDFF5d7", "_links_assignee_href": "https://dev-99779501.okta.com/api/v1/groups/00gl9xqojqXq0TJgS5d7"
}

Exemplo: remova a atribuição de um grupo a uma app

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação UnassignGrouptoApp e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
{
 "GroupId": "00gl5wovm8GuLr8vg5d7",
 "AppId": "0oakn3j0bfGPR1Esk5d7" 
}
```

Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:UnassignGrouptoAppconnectorOutputPayload

{
"Status": "Success"
}

Exemplo: remova a atribuição de um grupo a uma função

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação UnassignGrouptoRole e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
{
"GroupId": "00gl5wovm8GuLr8vg5d7",
"RoleAssignmentId": "irbl94sbyit77SGpg5d7"
}
```

Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:UnassignGrouptoRoleconnectorOutputPayload

{
"Status": "Success"
}

Exemplo: suspenda um utilizador

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação SuspendUser e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
{
"UserId": "00ulkdsubxO6W6LgJ5d7" 
}
```

Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:SuspendUserconnectorOutputPayload

{
"Status": "Success"
}

Exemplo: anule a suspensão de um utilizador

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação UnsuspendUser e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
{
"UserId": "00ulkdsubxO6W6LgJ5d7" 
}
```

Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:UnsuspendUserconnectorOutputPayload

{
"Status": "Success"
}

Exemplos de operações de entidades

Esta secção mostra como realizar algumas das operações de entidades neste conector.

Exemplo: liste todos os utilizadores

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Utilizadores na lista Entity.
Selecione a operação List e, de seguida, clique em Concluído.
Na secção Entrada de tarefas da tarefa Conectores, pode definir a filterClause de acordo com o seu requisito.

Tem de usar aspas simples (') para incluir o valor de uma cláusula de filtro. Pode usar a cláusula filter para filtrar registos com base nas colunas.

Exemplo: obter um utilizador

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Users na lista Entity.
Selecione a operação Get e, de seguida, clique em Concluído.
Defina o ID da entidade como "20001", que é a chave a ser transmitida. Para definir o ID da entidade, na secção Mapeador de dados do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e, em seguida, introduza "20001" no campo Valor de entrada e escolha EntityId como variável local.

Tem de transmitir o ID da entidade diretamente, como "20001". Aqui, "20001" é o valor da chave primária exclusivo, que é transmitido

Tem de usar a cláusula filter em consultas em que a transmissão de um ID de entidade geraria um erro, uma vez que existem duas chaves compostas, como id='20001'

Exemplo: elimine um utilizador

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Users na lista Entity.
Selecione a operação Delete e, de seguida, clique em Concluído.
Defina o ID da entidade como "00ul7l5fdyTdHDfSj5d7", que é a chave a transmitir.Para definir o ID da entidade, na secção Mapeador de dados do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e, em seguida, introduza "20001" no campo Valor de entrada e escolha EntityId como variável local.
Se a entidade tiver duas chaves empresariais ou primárias compostas em vez de especificar o entityId, também pode definir a filterClause como id='00ul7l5fdyTdHDfSj5d7'.

Exemplo: crie um utilizador

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Users na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.
```
{ "ProfileFirstName": "Test",
    "ProfileLastName": "Test User",
    "ProfileEmail": "Test@gmail.com",
    "ProfileLogin": "Test11@example.com"
}
```
Se a integração for bem-sucedida, o parâmetro de resposta da tarefa VendorconnectorOutputPayload terá um valor semelhante ao seguinte:
```
{
    "Id": "00ula502hjbwWYsO25d7"
}
```

Exemplo: crie um grupo

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Groups na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.
```
{
    "ProfileDescription": "Googlecloud group",
    "ProfileName": "Goolecloud created grp\n"
}
```
Se a integração for bem-sucedida, o parâmetro de resposta da tarefa APBillconnectorOutputPayload terá um valor semelhante ao seguinte:
```
{
    "Id": "00gl7lb5gniIAOMwA5d7"
}
```

Exemplo: crie uma app

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Apps na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.
```
{ "Label": "Googlecloud generated app",
    "SignOnMode": "AUTO_LOGIN",
    "AutoSubmitToolbar": false,
    "Settings": "{\"signOn\":{\"redirectUrl\":\"https://www.example.com\",\"loginUrl\":\"https://www.example.com\"}}"
}
```
Este exemplo cria o Vendtype. Se a integração for bem-sucedida, o parâmetro de resposta da tarefa VendtypeconnectorOutputPayload terá um valor semelhante ao seguinte:
```
{
    "Id": "0oal9vwooxEXXpdjS5d7"
}
```

Exemplo: crie uma função

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Roles na lista Entity.
Selecione a operação Create e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local.
```
{ "Label": "new role2", 
    "Description": "GABA Role1",
    "Permissions": "\"okta.users.read\", \"okta.groups.read\"" 
}
```
Se a integração for bem-sucedida, o parâmetro de resposta da tarefa CustomerconnectorOutputPayload terá um valor semelhante ao seguinte:
```
{
    "Id": "cr0l824rbiTvtJDoi5d7"
}
```

Exemplo: atualize um utilizador

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Users na lista Entity.
Selecione a operação Update e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
```
{
    "ProfileFirstName": "ShubhGillL" 
}
```
Defina o ID da entidade no mapeador de dados para a entidade dos utilizadores. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
Em vez de especificar o entityId, também pode definir a filterClause como 20044.

A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conetor:
```
{
    "Id": "00ul7u8cyobt8SGRK5d7" 
}
```

Exemplo: atualize um grupo

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Groups na lista Entity.
Selecione a operação Update e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
```
{
    "ProfileName": "Updated Googlecloud group"
}
```
Defina o ID da entidade no Mapeador de dados para a entidade dos grupos. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
Em vez de especificar o entityId, também pode definir a filterClause como 1371.

A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conetor:
```
{
    "Id": "00gl92veg4VSQQb5A5d7"
}
```

Exemplo: atualize uma app

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Apps na lista Entity.
Selecione a operação Update e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
```
{
    "Label": "Googlecloud updated label"
}
```
Defina o ID da entidade no Mapeador de dados para a entidade das apps. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
Em vez de especificar o entityId, também pode definir a filterClause como Customerid='10100'\n.

A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conetor:
```
{
    "Id": "0oal9vwooxEXXpdjS5d7"
}
```

Exemplo: atualizar uma função

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Roles na lista Entity.
Selecione a operação Update e, de seguida, clique em Concluído.
Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
```
{
    "Label": "Googlecloud updated label"
}
```
Defina o ID da entidade no Mapeador de dados para a entidade das funções. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
Em vez de especificar o entityId, também pode definir a filterClause como 1.

A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conetor:
```
{
    "Id": "cr0l7dqeatRuIrn5x5d7"
}
```

Obtenha ajuda da comunidade do Google Cloud

Pode publicar as suas perguntas e discutir este conector na comunidade do Google Cloud nos Fóruns do Cloud.

O que se segue?

Compreenda como suspender e retomar uma associação.
Compreenda como monitorizar a utilização do conector.
Compreenda como ver os registos do conetor.