O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Okta

Você pode usar o conector do Okta para criar, ler, atualizar e excluir registros de usuários, grupos, funções e apps, além de atribuir ou remover a atribuição de usuários ou grupos a funções e aplicativos.

Antes de começar

No seu projeto do Google Cloud, faça o seguinte:

Verifique se a conectividade de rede está configurada. Para informações sobre padrões de rede, consulte Conectividade de rede.
Conceda ao usuário que está configurando o conector o papel do IAM roles/connectors.admin.
Conceda os papéis do IAM roles/secretmanager.viewer e roles/secretmanager.secretAccessor à conta de serviço que você quer usar para o conector.
Ative os seguintes serviços:
- secretmanager.googleapis.com (API Secret Manager)
- connectors.googleapis.com (API Connectors)
Para entender como ativar os serviços, consulte Como ativar serviços. Se esses serviços ou permissões não tiverem sido ativados no seu projeto, você precisará ativá-los ao configurar o conector.

Criar uma conexão do Okta

Uma conexão é específica a uma fonte de dados. Isso significa que, se você tiver muitas fontes de dados, precisará criar uma conexão separada para cada uma. Para criar uma conexão, faça o seguinte:

No console do Cloud, acesse a página Integration Connectors > Conexões e selecione ou crie um projeto do Google Cloud.
Acessar a página "Conexões"
Clique em + Criar novo para abrir a página Criar conexão.
Na seção Local, escolha o local da conexão.
1. Região: selecione um local na lista suspensa.
  Para conferir a lista de todas as regiões com suporte, consulte Locais.
2. Clique em Próxima.
Na seção Detalhes da conexão, faça o seguinte:
1. Selecione Okta na lista Conector.
2. Selecione uma versão do conector na lista Versão do conector.
3. No campo Nome da conexão, insira um nome para a instância de conexão. O nome da conexão pode conter letras minúsculas, números ou hífens. O nome precisa começar com uma letra e terminar com uma letra ou um número, e não pode ter mais de 49 caracteres.
4. Como opção, insira uma Descrição para a instância de conexão.
5. Como opção, ative o Cloud Logging e selecione um nível de registro. Por padrão, o nível de registro é definido como Error.
6. Conta de serviço: selecione uma conta de serviço que tenha os papéis necessários.
7. Domínio: insira um domínio do Okta para se conectar à instância.
8. Outra opção é clicar em + Adicionar rótulo para adicionar um rótulo à conexão na forma de um par de chave-valor.
9. Clique em Próxima.
Na seção Autenticação, insira os detalhes da autenticação.
1. Selecione um Tipo de autenticação e insira os detalhes relevantes.
  A conexão do Okta aceita os seguintes tipos de autenticação:
  - Código de autorização OAuth 2.0
  - Credenciais do cliente OAuth 2.0 com portador JWT
2. Clique em Next.
Revisão: revise os detalhes de conexão e autenticação.
Clique em Criar.

Configurar a autenticação

Digite os detalhes com base na autenticação que você quer usar.

Código de autorização OAuth 2.0
- ID do cliente: o ID do cliente usado para solicitar tokens de acesso.
- Escopos: uma lista separada por vírgulas dos escopos desejados.
- Chave secreta do cliente: a chave secreta usada para solicitar tokens de acesso.
- URL de autorização: o URL de autorização gerado ao criar o cliente.

Para o tipo de autenticação Authorization code, depois de criar a conexão, execute mais algumas etapas para configurar a autenticação. Para mais informações, consulte Etapas adicionais após a criação da conexão.

OAuth 2.0 - Credenciais do cliente com portador JWT
- ID do cliente: o ID do cliente usado para solicitar tokens de acesso.
- Escopos: uma lista separada por vírgulas dos escopos desejados.
- Chave privada: o secret do Secret Manager que contém o conteúdo do arquivo da chave privada no formato PEM. A chave privada precisa corresponder à chave pública/certificado.

Etapas adicionais após a criação da conexão

Se você selecionou OAuth 2.0 - Authorization code para autenticação, siga estas etapas adicionais depois de criar a conexão:

Na página "Conexões", localizar a conexão recém-criada.
O Status do novo conector será Autorização necessária.
Clique em Autorização necessária.
O painel Editar autorização é exibido.
Copie o valor de URI de redirecionamento para seu aplicativo externo.
Verifique os detalhes da autorização.
Clique em Autorizar.
Se a autorização for bem-sucedida, o status da conexão será definido como Ativo na página "Conexões".

Reautorização do código de autorização

Se você estiver usando o tipo de autenticação Authorization code e tiver feito alterações de configuração, será necessário autorizar novamente a conexão do Okta. Para reautorizar uma conexão, siga estas etapas:

Clique na conexão desejada na página "Conexões".
Isso abre a página de detalhes da conexão.
Clique em Editar para mudar os detalhes da conexão.
Verifique os detalhes do Código de autorização do OAuth 2.0 na seção Autenticação.
Se necessário, faça as mudanças necessárias.
Clique em Salvar. Isso leva você à página de detalhes da conexão.
Clique em Editar autorização na seção Autenticação. O painel Autorizar é exibido.
Clique em Autorizar.
Se a autorização for concluída, o status da conexão será definido como Ativo na página "Conexões".

Limitações do sistema

O conector do Okta pode processar no máximo uma transação por segundo, por nó, e limita qualquer transação além desse limite. Por padrão, o Integration Connectors aloca dois nós (para melhor disponibilidade) para uma conexão.

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

Observação:o número de nós do Integration Connectors será escalonado automaticamente de forma dinâmica com base no seu uso. No entanto, se você quiser reservar capacidade para grandes volumes sem esperar pelo escalonamento automático, ajuste o valor mínimo do nó para uma conexão. Mais nós são necessários para processar mais transações para uma conexão. Por outro lado, menos nós são necessários se uma conexão processar menos transações. Para configurar os valores do nó, faça o seguinte:

Se você for um cliente de pagamento por uso, configure o valor mínimo e máximo do nó na página de edição da conexão.
Se você for um cliente por assinatura, entre em contato com o suporte.

O número máximo de transações que um nó pode processar depende de vários fatores. Portanto, antes de ajustar o número mínimo de nós para melhorar a capacidade de processamento, é recomendável verificar se os sistemas de back-end estão configurados de maneira ideal para lidar com o tráfego necessário.

Usar a conexão do Okta em uma integração

Depois de criar a conexão, ela fica disponível na Apigee Integration e no Application Integration. É possível usar a conexão em uma integração pela tarefa de conectores.

Para entender como criar e usar a tarefa "Conectores" na integração da Apigee, consulte Tarefa "Conectores".
Para entender como criar e usar a tarefa "Conectores" na Application Integration, consulte Tarefa "Conectores".

Ações

Esta seção lista as ações compatíveis com o conector do Okta. Para entender como configurar as ações, consulte Exemplos de ações.

Ação ReactivateUser

Essa ação reativa um usuário.

Parâmetros de entrada da ação ReactivateUser

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
UserID	String	Verdadeiro	O ID do usuário.

Para ver um exemplo de como configurar a ação ReactivateUser, consulte Exemplo de ActivateUser.

Ação ActivateUser

Essa ação ativa um usuário.

Parâmetros de entrada da ação ActivateUser

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
UserID	String	Verdadeiro	O ID do usuário.

Para ver um exemplo de como configurar a ação ActivateUser, consulte Exemplo de ActivateUser.

Ação DeactivateUser

Essa ação desativa um usuário.

Parâmetros de entrada da ação DeactivateUser

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
UserID	String	Verdadeiro	O ID do usuário.

Para ver um exemplo de como configurar a ação DeactivateUser, consulte Exemplo de DeactivateUser.

Ação Assignusertogroup

Essa ação atribui um usuário a um grupo.

Parâmetros de entrada da ação Assignusertogroup

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
UserID	String	Verdadeiro	O ID do usuário.
GroupID	String	Verdadeiro	O ID do grupo.

Para ver um exemplo de como configurar a ação Assignusertogroup, consulte Exemplo de Assignusertogroup.

Ação UnassignUsertoRole

Essa ação cancela a atribuição de um usuário a uma função.

Parâmetros de entrada da ação UnassignUsertoRole

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
UserID	String	Verdadeiro	O ID do usuário.
RoleAssignmentId	String	Verdadeiro	O ID da função.

Para um exemplo de como configurar a ação UnassignUsertoRole, consulte Exemplo de UnassignUsertoRole.

Ação AssignUsertoRole

Essa ação atribui um usuário a uma função.

Parâmetros de entrada da ação AssignUsertoRole

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
UserID	String	Verdadeiro	O ID do usuário.
RoleId	String	Verdadeiro	O ID da função.

Para ver um exemplo de como configurar a ação AssignUsertoRole, consulte Exemplo de AssignUsertoRole.

Ação AssignUsertoApp

Essa ação atribui um usuário a um app.

Parâmetros de entrada da ação AssignUsertoApp

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
UserID	String	Verdadeiro	O ID do usuário.
AppId	String	Verdadeiro	O ID do app.

Para um exemplo de como configurar a ação AssignUsertoApp, consulte Exemplo de AssignUsertoApp.

Ação "UnassignUsertoGroup"

Essa ação remove um usuário de um grupo.

Parâmetros de entrada da ação UnassignUsertoGroup

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
UserID	String	Verdadeiro	O ID do usuário.
GroupID	String	Verdadeiro	O ID do grupo.

Para um exemplo de como configurar a ação UnassignUsertoGroup, consulte Exemplo de UnassignUsertoGroup.

Ação UnassignUsertoApp

Essa ação remove a atribuição de um usuário a um app.

Parâmetros de entrada da ação UnassignUsertoApp

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
UserID	String	Verdadeiro	O ID do usuário.
AppID	String	Verdadeiro	O ID do app.

Para ver um exemplo de como configurar a ação UnassignUsertoApp, consulte Exemplo de UnassignUsertoApp.

Ação "assigngrouptoapp"

Essa ação atribui um grupo a um app.

Parâmetros de entrada da ação Assigngrouptoapp

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

Para ver um exemplo de como configurar a ação Assigngrouptoapp, consulte Exemplo de Assigngrouptoapp.

Ação AssignGrouptoRole

Essa 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ório	Descrição
GroupId	String	Verdadeiro	O ID do grupo
RoleId	String	Verdadeiro	O ID da função
TypeId	String	Verdadeiro	O ID do tipo

Para um exemplo de como configurar a ação AssignGrouptoRole, consulte Exemplo de AssignGrouptoRole.

Ação UnassignGrouptoApp

Essa ação remove a atribuição de um grupo a um app.

Parâmetros de entrada da ação UnassignGrouptoApp

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

Para ver um exemplo de como configurar a ação UnassignGrouptoApp, consulte Exemplo de UnassignGrouptoApp.

Ação UnassignGrouptoRole

Essa ação remove a atribuição de um grupo a um papel.

Parâmetros de entrada da ação UnassignGrouptoRole

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

Para um exemplo de como configurar a ação UnassignGrouptoRole, consulte Exemplo de UnassignGrouptoRole.

Ação SuspendUser

Essa ação suspende um usuário.

Parâmetros de entrada da ação SuspendUser

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

Para ver um exemplo de como configurar a ação SuspendUser, consulte Exemplo de SuspendUser.

Ação UnsuspendUser

Essa ação retira a suspensão de um usuário.

Parâmetros de entrada da ação UnsuspendUser

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

Para ver um exemplo de como configurar a ação UnsuspendUser, consulte Exemplo de UnsuspendUser.

Exemplos de ações

Exemplo: reativar um usuário

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

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da ReactivateUser tarefa terá um valor semelhante a este:

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

Exemplo: ativar um usuário

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

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da ActivateUser tarefa terá um valor semelhante a este:

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

Exemplo: desativar um usuário

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

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da DeactivateUser tarefa terá um valor semelhante a este:

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

Exemplo: atribuir um usuário a um grupo

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação Assignusertogroup e clique em Concluído.
Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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 connectorOutputPayload da Assignusertogroup tarefa terá um valor semelhante a este:

{
 "Status": "Success",
}

Exemplo: cancelar a atribuição de um usuário a uma função

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação UnassignUsertoRole e clique em Concluído.
Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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 connectorOutputPayload da UnassignUsertoRole tarefa terá um valor semelhante a este:

{
 "Status": "Success",
}

Exemplo: atribuir um usuário a uma função

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação AssignUsertoRole e clique em Concluído.
Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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 connectorOutputPayload da AssignUsertoRole tarefa terá um valor semelhante a este:

{
 "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: atribuir um usuário a um app

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação AssignUsertoApp e clique em Concluído.
Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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 connectorOutputPayload da AssignUsertoApp tarefa terá um valor semelhante a este:

{
    "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: cancelar a atribuição de um usuário a um grupo

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação UnassignUsertoGroup e clique em Concluído.
Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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 connectorOutputPayload da UnassignUsertoGroup tarefa terá um valor semelhante a este:

{
"Status": "Success"
}

Exemplo: cancelar a atribuição de um usuário a um app

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação UnassignUsertoApp e clique em Concluído.
Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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 connectorOutputPayload da UnassignUsertoApp tarefa terá um valor semelhante a este:

 
{
"Status": "Success"
}

Exemplo: atribuir um grupo a um app

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação Assigngrouptoapp e clique em Concluído.
Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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 connectorOutputPayload da Assigngrouptoapp tarefa terá um valor semelhante a este:

{
"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: atribuir um grupo a uma função

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação AssignGrouptoRole e clique em Concluído.
Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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 connectorOutputPayload da AssignGrouptoRole tarefa terá um valor semelhante a este:

{
"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: remover a atribuição de um grupo de um app

Na caixa de diálogo Configure connector task, clique em Actions.
Selecione a ação UnassignGrouptoApp e clique em Concluído.
Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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 connectorOutputPayload da UnassignGrouptoApp tarefa terá um valor semelhante a este:

{
"Status": "Success"
}

Exemplo: cancelar 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 clique em Concluído.
Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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 connectorOutputPayload da UnassignGrouptoRole tarefa terá um valor semelhante a este:

{
"Status": "Success"
}

Exemplo: suspender um usuário

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

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da SuspendUser tarefa terá um valor semelhante a este:

{
"Status": "Success"
}

Exemplo: cancelar a suspensão de um usuário

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

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da UnsuspendUser tarefa terá um valor semelhante a este:

{
"Status": "Success"
}

Exemplos de operações de entidade

Nesta seção, mostramos como realizar algumas das operações de entidade neste conector.

Exemplo: listar todos os usuários

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione "Usuários" na lista Entity.
Selecione a operação List e clique em Concluído.
Na seção Entrada de tarefa da tarefa Conectores, é possível definir a filterClause de acordo com sua necessidade.

Use aspas simples (') para colocar o valor de uma cláusula de filtro. É possível usar a cláusula de filtro para filtrar registros com base nas colunas.

Exemplo: receber um usuário

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Users na lista Entity.
Selecione a operação Get e clique em Concluído.
Defina o ID da entidade como "20001", que é a chave a ser transmitida. Para definir o ID da entidade, na seção Data Mapper do Data Mapping, clique em Open Data Mapping Editor e digite "20001" no campo Input Value. Escolha EntityId como variável local.

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

É necessário usar a cláusula de filtro em consultas em que a transmissão de um ID de entidade geraria um erro, já que haverá duas chaves compostas, como id='20001'.

Exemplo: excluir um usuário

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

Exemplo: criar um usuário

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Users na lista Entity.
Selecione a operação Create e clique em Concluído.
Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira 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 connectorOutputPayload da tarefa Vendor terá um valor semelhante a este:
```
{
    "Id": "00ula502hjbwWYsO25d7"
}
```

Exemplo: criar um grupo

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Groups na lista Entity.
Selecione a operação Create e clique em Concluído.
Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira 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 connectorOutputPayload da tarefa APBill terá um valor semelhante a este:
```
{
    "Id": "00gl7lb5gniIAOMwA5d7"
}
```

Exemplo: criar um app

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Apps na lista Entity.
Selecione a operação Create e clique em Concluído.
Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira 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 vai criar o Vendtype. Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa Vendtype terá um valor semelhante a este:
```
{
    "Id": "0oal9vwooxEXXpdjS5d7"
}
```

Exemplo: criar 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 clique em Concluído.
Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira 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 connectorOutputPayload da tarefa Customer terá um valor semelhante a este:
```
{
    "Id": "cr0l824rbiTvtJDoi5d7"
}
```

Exemplo: atualizar um usuário

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Users na lista Entity.
Selecione a operação Update e clique em Concluído.
Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira 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 Data Mapper como a entidade dos usuários. Para definir o ID da entidade, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value. Escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
Em vez de especificar o entityId, você também pode definir a filterClause como 20044.

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

Exemplo: atualizar um grupo

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Groups na lista Entity.
Selecione a operação Update e clique em Concluído.
Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira 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 Data Mapper como a entidade dos grupos. Para definir o ID da entidade, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value. Escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
Em vez de especificar o entityId, você também pode definir a filterClause como 1371.

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

Exemplo: atualizar um app

Na caixa de diálogo Configure connector task, clique em Entities.
Selecione Apps na lista Entity.
Selecione a operação Update e clique em Concluído.
Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira 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 Data Mapper como a entidade dos apps. Para definir o ID da entidade, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value. Escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
Em vez de especificar o entityId, você também pode definir a filterClause como Customerid='10100'\n.

A execução deste exemplo retorna uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conector:
```
{
    "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 clique em Concluído.
Na seção Data Mapper da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e insira 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 Data Mapper como a entidade das funções. Para definir o ID da entidade, clique em Open Data Mapping Editor e insira um valor semelhante ao seguinte no campo Input Value. Escolha EntityId/ConnectorInputPayload/FilterClause como variável local.
Em vez de especificar o entityId, você também pode definir a filterClause como 1.

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

Receber ajuda da comunidade do Google Cloud

Poste suas dúvidas e converse sobre esse conector na comunidade do Google Cloud em Fóruns do Cloud.

A seguir

Entenda como suspender e retomar uma conexão.
Entenda como monitorar o uso do conector.
Saiba como ver os registros do conector.