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.viewereroles/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.
- 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.
- Região: selecione uma localização na lista pendente.
Para ver a lista de todas as regiões suportadas, consulte o artigo Localizações.
- Clicar em Seguinte.
- Região: selecione uma localização na lista pendente.
- Na secção Detalhes da associação, conclua o seguinte:
- Selecione Okta na lista Conetor.
- Selecione uma versão do conetor na lista Versão do conetor.
- 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.
- Opcionalmente, introduza uma Descrição para a instância de associação.
- 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. - Conta de serviço: selecione uma conta de serviço que tenha as funções necessárias.
- (Opcional) Configure as definições do nó de associação.
- Número mínimo de nós: introduza o número mínimo de nós de ligação.
- Número máximo de nós: introduza o número máximo de nós de ligação.
- Domínio: introduza um domínio do Okta para estabelecer ligação à instância do Okta.
- Opcionalmente, clique em + Adicionar etiqueta para adicionar uma etiqueta à associação sob a forma de um par chave/valor.
- Clicar em Seguinte.
Um nó é uma unidade (ou uma réplica) de uma ligação que processa transações. São necessários mais nós para processar mais transações para uma ligação e, inversamente, são necessários menos nós para processar menos transações. Para compreender como os nós afetam os preços dos conectores, consulte o artigo Preços dos nós de ligação. Se não introduzir valores, por predefinição, os nós mínimos são definidos como 2 (para uma melhor disponibilidade) e os nós máximos são definidos como 50.
-
Na secção Autenticação, introduza os detalhes de autenticação.
- 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
- Clicar em Seguinte.
Para saber como configurar estes tipos de autenticação, consulte o artigo Configurar autenticação.
- Selecione um Tipo de autenticação e introduza os detalhes relevantes.
- 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.
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 emActions. - Selecione a ação
ReactivateUsere, de seguida, clique em Concluído. - Na secção Entrada da tarefa da tarefa Conetores, clique em
connectorInputPayloade, de seguida, introduza um valor semelhante ao seguinte no campoDefault 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 emActions. - Selecione a ação
ActivateUsere, de seguida, clique em Concluído. - Na secção Entrada da tarefa da tarefa Conetores, clique em
connectorInputPayloade, de seguida, introduza um valor semelhante ao seguinte no campoDefault 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 emActions. - Selecione a ação
DeactivateUsere, de seguida, clique em Concluído. - Na secção Entrada da tarefa da tarefa Conetores, clique em
connectorInputPayloade, de seguida, introduza um valor semelhante ao seguinte no campoDefault 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 emActions. - Selecione a ação
Assignusertogroupe, de seguida, clique em Concluído. - Na secção Entrada da tarefa da tarefa Conetores, clique em
connectorInputPayloade, de seguida, introduza um valor semelhante ao seguinte no campoDefault 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 emActions. - Selecione a ação
UnassignUsertoRolee, de seguida, clique em Concluído. - Na secção Entrada da tarefa da tarefa Conetores, clique em
connectorInputPayloade, de seguida, introduza um valor semelhante ao seguinte no campoDefault 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 emActions. - Selecione a ação
AssignUsertoRolee, de seguida, clique em Concluído. - Na secção Entrada da tarefa da tarefa Conetores, clique em
connectorInputPayloade, de seguida, introduza um valor semelhante ao seguinte no campoDefault 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 emActions. - Selecione a ação
AssignUsertoAppe, de seguida, clique em Concluído. - Na secção Entrada da tarefa da tarefa Conetores, clique em
connectorInputPayloade, de seguida, introduza um valor semelhante ao seguinte no campoDefault 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 emActions. - Selecione a ação
UnassignUsertoGroupe, de seguida, clique em Concluído. - Na secção Entrada da tarefa da tarefa Conetores, clique em
connectorInputPayloade, de seguida, introduza um valor semelhante ao seguinte no campoDefault 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 emActions. - Selecione a ação
UnassignUsertoAppe, de seguida, clique em Concluído. - Na secção Entrada da tarefa da tarefa Conetores, clique em
connectorInputPayloade, de seguida, introduza um valor semelhante ao seguinte no campoDefault 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 emActions. - Selecione a ação
Assigngrouptoappe, de seguida, clique em Concluído. - Na secção Entrada da tarefa da tarefa Conetores, clique em
connectorInputPayloade, de seguida, introduza um valor semelhante ao seguinte no campoDefault 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 emActions. - Selecione a ação
AssignGrouptoRolee, de seguida, clique em Concluído. - Na secção Entrada da tarefa da tarefa Conetores, clique em
connectorInputPayloade, de seguida, introduza um valor semelhante ao seguinte no campoDefault 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 emActions. - Selecione a ação
UnassignGrouptoAppe, de seguida, clique em Concluído. - Na secção Entrada da tarefa da tarefa Conetores, clique em
connectorInputPayloade, de seguida, introduza um valor semelhante ao seguinte no campoDefault 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 emActions. - Selecione a ação
UnassignGrouptoRolee, de seguida, clique em Concluído. - Na secção Entrada da tarefa da tarefa Conetores, clique em
connectorInputPayloade, de seguida, introduza um valor semelhante ao seguinte no campoDefault 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 emActions. - Selecione a ação
SuspendUsere, de seguida, clique em Concluído. - Na secção Entrada da tarefa da tarefa Conetores, clique em
connectorInputPayloade, de seguida, introduza um valor semelhante ao seguinte no campoDefault 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 emActions. - Selecione a ação
UnsuspendUsere, de seguida, clique em Concluído. - Na secção Entrada da tarefa da tarefa Conetores, clique em
connectorInputPayloade, de seguida, introduza um valor semelhante ao seguinte no campoDefault 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 emEntities. - Selecione Utilizadores na lista
Entity. - Selecione a operação
Liste, 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 emEntities. - Selecione
Usersna listaEntity. - Selecione a operação
Gete, 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 emEntities. - Selecione
Usersna listaEntity. - Selecione a operação
Deletee, 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 emEntities. - Selecione
Usersna listaEntity. - Selecione a operação
Createe, de seguida, clique em Concluído. - Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em
Open Data Mapping Editore, de seguida, introduza um valor semelhante ao seguinte no campoInput Valuee 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
VendorconnectorOutputPayloadterá um valor semelhante ao seguinte:{ "Id": "00ula502hjbwWYsO25d7" }
Exemplo: crie um grupo
- Na caixa de diálogo
Configure connector task, clique emEntities. - Selecione
Groupsna listaEntity. - Selecione a operação
Createe, de seguida, clique em Concluído. - Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em
Open Data Mapping Editore, de seguida, introduza um valor semelhante ao seguinte no campoInput Valuee 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
APBillconnectorOutputPayloadterá um valor semelhante ao seguinte:{ "Id": "00gl7lb5gniIAOMwA5d7" }
Exemplo: crie uma app
- Na caixa de diálogo
Configure connector task, clique emEntities. - Selecione
Appsna listaEntity. - Selecione a operação
Createe, de seguida, clique em Concluído. - Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em
Open Data Mapping Editore, de seguida, introduza um valor semelhante ao seguinte no campoInput Valuee 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
VendtypeconnectorOutputPayloadterá um valor semelhante ao seguinte:{ "Id": "0oal9vwooxEXXpdjS5d7" }
Exemplo: crie uma função
- Na caixa de diálogo
Configure connector task, clique emEntities. - Selecione
Rolesna listaEntity. - Selecione a operação
Createe, de seguida, clique em Concluído. - Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em
Open Data Mapping Editore, de seguida, introduza um valor semelhante ao seguinte no campoInput Valuee 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
CustomerconnectorOutputPayloadterá um valor semelhante ao seguinte:{ "Id": "cr0l824rbiTvtJDoi5d7" }
Exemplo: atualize um utilizador
- Na caixa de diálogo
Configure connector task, clique emEntities. - Selecione
Usersna listaEntity. - Selecione a operação
Updatee, de seguida, clique em Concluído. - Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em
Open Data Mapping Editore, de seguida, introduza um valor semelhante ao seguinte no campoInput Valuee 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 Editore, de seguida, introduza um valor semelhante ao seguinte no campoInput Valuee 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
connectorOutputPayloadda tarefa do conetor:{ "Id": "00ul7u8cyobt8SGRK5d7" }
Exemplo: atualize um grupo
- Na caixa de diálogo
Configure connector task, clique emEntities. - Selecione
Groupsna listaEntity. - Selecione a operação
Updatee, de seguida, clique em Concluído. - Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em
Open Data Mapping Editore, de seguida, introduza um valor semelhante ao seguinte no campoInput Valuee 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 Editore, de seguida, introduza um valor semelhante ao seguinte no campoInput Valuee 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
connectorOutputPayloadda tarefa do conetor:{ "Id": "00gl92veg4VSQQb5A5d7" }
Exemplo: atualize uma app
- Na caixa de diálogo
Configure connector task, clique emEntities. - Selecione
Appsna listaEntity. - Selecione a operação
Updatee, de seguida, clique em Concluído. - Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em
Open Data Mapping Editore, de seguida, introduza um valor semelhante ao seguinte no campoInput Valuee 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 Editore, de seguida, introduza um valor semelhante ao seguinte no campoInput Valuee 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
connectorOutputPayloadda tarefa do conetor:{ "Id": "0oal9vwooxEXXpdjS5d7" }
Exemplo: atualizar uma função
- Na caixa de diálogo
Configure connector task, clique emEntities. - Selecione
Rolesna listaEntity. - Selecione a operação
Updatee, de seguida, clique em Concluído. - Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em
Open Data Mapping Editore, de seguida, introduza um valor semelhante ao seguinte no campoInput Valuee 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 Editore, de seguida, introduza um valor semelhante ao seguinte no campoInput Valuee 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
connectorOutputPayloadda 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.