Okta
Vous pouvez utiliser le connecteur Okta pour créer, lire, mettre à jour et supprimer des enregistrements d'utilisateur, de groupe, de rôle et d'application, et pour attribuer ou retirer des utilisateurs ou des groupes à des rôles et des applications.
Avant de commencer
Dans votre projet Google Cloud, effectuez les tâches suivantes :
- Assurez-vous que la connectivité réseau est configurée. Pour en savoir plus sur les schémas de réseau, consultez Connectivité réseau.
- Attribuez le rôle IAM roles/connectors.admin à l'utilisateur qui configure le connecteur.
- Attribuez les rôles IAM
roles/secretmanager.viewer
etroles/secretmanager.secretAccessor
au compte de service que vous souhaitez utiliser pour le connecteur. - Activez les services suivants :
secretmanager.googleapis.com
(API Secret Manager)connectors.googleapis.com
(API Connectors)
Pour savoir comment activer des services, consultez Activer des services. Si ces services ou autorisations n'ont pas encore été activés pour votre projet, vous êtes invité à les activer au moment de configurer le connecteur.
Créer une connexion Okta
Une connexion est propre à une source de données. Cela signifie que si vous disposez de nombreuses sources de données, vous devez créer une connexion distincte pour chacune d'elles. Pour créer une connexion, procédez comme suit :
- Dans la console Cloud, accédez à la page Connecteurs d'intégration > Connexions, puis sélectionnez ou créez un projet Google Cloud.
- Cliquez sur + Créer pour ouvrir la page Créer une connexion.
- Dans la section Emplacement, choisissez l'emplacement de la connexion.
- Région : sélectionnez un emplacement dans la liste déroulante.
Pour obtenir la liste de toutes les régions disponibles, consultez Emplacements.
- Cliquez sur Suivant.
- Région : sélectionnez un emplacement dans la liste déroulante.
- Dans la section Détails de connexion, procédez comme suit :
- Sélectionnez Okta dans la liste Connecteur.
- Sélectionnez une version de connecteur dans la liste Version du connecteur.
- Dans le champ Nom de connexion, indiquez le nom de l'instance de connexion. Le nom de la connexion peut contenir des lettres minuscules, des chiffres ou des traits d'union. Il doit commencer par une lettre et se terminer par une lettre ou un chiffre. Il ne doit pas dépasser 49 caractères.
- (Facultatif) Saisissez une description de l'instance de connexion.
- (Facultatif) Activez Cloud Logging, puis sélectionnez un niveau de journalisation. Par défaut, le niveau de journalisation est défini sur
Error
. - Compte de service : sélectionnez un compte de service disposant des rôles requis.
- (Facultatif) Configurez les paramètres de nœuds de connexion.
- Nombre minimal de nœuds : saisissez le nombre minimal de nœuds de connexion.
- Nombre maximal de nœuds : saisissez le nombre maximal de nœuds de connexion.
- Domaine : saisissez un domaine Okta pour vous connecter à l'instance Okta.
- (Facultatif) Cliquez sur + Ajouter une étiquette pour ajouter une étiquette à la connexion sous la forme d'une paire clé/valeur.
- Cliquez sur Suivant.
Un nœud est une unité (ou instance répliquée) de connexion qui traite des transactions. Pour traiter davantage de transactions pour une connexion, vous devez disposer de plus de nœuds. À l'inverse, moins de nœuds sont nécessaires si une connexion traite moins de transactions. Pour comprendre comment les nœuds affectent la tarification de votre connecteur, consultez Tarifs des nœuds de connexion. Si vous ne saisissez aucune valeur, le nombre minimal de nœuds est défini par défaut sur 2 (pour améliorer la disponibilité) et le nombre maximal de nœuds sur 50.
-
Dans la section Authentification, saisissez les informations d'authentification.
- Sélectionnez un type d'authentification, puis saisissez les informations appropriées.
Les types d'authentification suivants sont compatibles avec la connexion Okta :
- Code d'autorisation OAuth 2.0
- Identifiants client OAuth 2.0 avec un jeton de support JWT
- Cliquez sur Suivant.
Pour savoir comment configurer ces types d'authentification, consultez Configurer l'authentification.
- Sélectionnez un type d'authentification, puis saisissez les informations appropriées.
- Vérifier : vérifiez vos informations de connexion et d'authentification.
- Cliquez sur Créer.
Configurer l'authentification
Saisissez les informations en fonction de l'authentification que vous souhaitez utiliser.
- Code d'autorisation OAuth 2.0
- ID client : ID client utilisé pour demander des jetons d'accès.
- Niveaux d'accès : liste des niveaux d'accès souhaités, séparés par une virgule.
- Code secret du client : code secret du client utilisé pour demander des jetons d'accès.
- URL d'autorisation : URL d'autorisation générée lors de la création du client.
Pour le type d'authentification Authorization code
, après avoir créé la connexion, vous devez effectuer quelques étapes supplémentaires pour configurer l'authentification. Pour en savoir plus, consultez Étapes supplémentaires après la création de la connexion.
-
Identifiants client OAuth 2.0 avec un jeton de support JWT
- ID client : ID client utilisé pour demander des jetons d'accès.
- Niveaux d'accès : liste des niveaux d'accès souhaités, séparés par une virgule.
- Clé privée : secret Secret Manager comportant le contenu du fichier de clé privée au format PEM. La clé privée doit correspondre à la clé publique/au certificat.
Étapes supplémentaires après la création de la connexion
Si vous avez sélectionné OAuth 2.0 - Authorization code
pour l'authentification, vous devez effectuer les étapes supplémentaires ci-dessous après avoir créé la connexion :
- Sur la page Connexions, recherchez la connexion que vous venez de créer.
Notez que l'état du nouveau connecteur sera Autorisation requise.
- Cliquez sur Autorisation requise.
Le volet Modifier l'autorisation s'affiche.
- Copiez la valeur de l'URI de redirection dans votre application externe.
- Vérifiez les détails de l'autorisation.
- Cliquez sur Autoriser.
Si l'autorisation aboutit, l'état de la connexion est défini sur Active sur la page Connexions.
Accorder une nouvelle autorisation pour le code d'autorisation
Si vous utilisez le type d'authentification Authorization code
et que vous avez modifié la configuration, vous devez autoriser à nouveau votre connexion Okta. Pour autoriser à nouveau une connexion, procédez comme suit :
- Sur la page Connexions, cliquez sur la connexion requise.
La page des détails de la connexion s'ouvre.
- Cliquez sur Modifier pour modifier les détails de la connexion.
- Dans la section Authentification, vérifiez les détails du code d'autorisation OAuth 2.0.
Apportez des modifications, si besoin.
- Cliquez sur Enregistrer. La page des détails de la connexion s'affiche.
- Dans la section Authentification, cliquez sur Modifier l'autorisation. Le volet Autoriser s'affiche.
- Cliquez sur Autoriser.
Si l'autorisation aboutit, l'état de la connexion est défini sur Active sur la page Connexions.
Limites du système
Le connecteur Okta peut traiter au maximum une transaction par seconde et par nœud, et limite les transactions qui dépassent ce seuil. Par défaut, Integration Connectors alloue deux nœuds (pour améliorer la disponibilité) à une connexion.
Pour en savoir plus sur les limites applicables à Integration Connectors, consultez Limites.
Utiliser la connexion Okta dans une intégration
Une fois la connexion créée, elle devient disponible dans Apigee Integration et Application Integration. Vous pouvez utiliser la connexion dans une intégration au moyen de la tâche "Connecteurs".
- Pour savoir comment créer et utiliser la tâche "Connecteurs" dans Apigee Integration, consultez Tâche "Connecteurs".
- Pour savoir comment créer et utiliser la tâche "Connecteurs" dans Application Integration, consultez Tâche "Connecteurs".
Actions
Dans cette section, vous trouverez la liste des actions prises en charge par le connecteur Okta. Pour savoir comment configurer les actions, consultez Exemples d'actions.
Action ReactivateUser
Cette action réactive un utilisateur.
Paramètres d'entrée de l'action ReactivateUser
Nom du paramètre | Type de données | Obligatoire | Description |
---|---|---|---|
UserID | STRING | True | ID de l'utilisateur |
Pour savoir comment configurer l'action ReactivateUser
, consultez l'exemple pour ActivateUser.
Action ActivateUser
Cette action active un utilisateur.
Paramètres d'entrée de l'action ActivateUser
Nom du paramètre | Type de données | Obligatoire | Description |
---|---|---|---|
UserID | STRING | True | ID de l'utilisateur |
Pour savoir comment configurer l'action ActivateUser
, consultez l'exemple pour ActivateUser.
Action DeactivateUser
Cette action désactive un utilisateur.
Paramètres d'entrée de l'action DeactivateUser
Nom du paramètre | Type de données | Obligatoire | Description |
---|---|---|---|
UserID | STRING | True | ID de l'utilisateur |
Pour savoir comment configurer l'action DeactivateUser
, consultez l'exemple pour DeactivateUser.
Action Assignusertogroup
Cette action attribue un utilisateur à un groupe.
Paramètres d'entrée de l'action Assignusertogroup
Nom du paramètre | Type de données | Obligatoire | Description |
---|---|---|---|
UserID | STRING | True | ID de l'utilisateur |
GroupID | STRING | True | ID du groupe |
Pour savoir comment configurer l'action Assignusertogroup
, consultez l'exemple pour Assignusertogroup.
Action UnassignUsertoRole
Cette action retire le rôle d'un utilisateur.
Paramètres d'entrée de l'action UnassignUsertoRole
Nom du paramètre | Type de données | Obligatoire | Description |
---|---|---|---|
UserID | STRING | True | ID de l'utilisateur |
RoleAssignmentId | STRING | True | ID du rôle |
Pour savoir comment configurer l'action UnassignUsertoRole
, consultez l'exemple pour UnassignUsertoRole.
Action AssignUsertoRole
Cette action attribue un utilisateur à un rôle.
Paramètres d'entrée de l'action AssignUsertoRole
Nom du paramètre | Type de données | Obligatoire | Description |
---|---|---|---|
UserID | STRING | True | ID de l'utilisateur |
RoleId | STRING | True | ID du rôle |
Pour savoir comment configurer l'action AssignUsertoRole
, consultez l'exemple pour AssignUsertoRole.
Action AssignUsertoApp
Cette action attribue un utilisateur à une application.
Paramètres d'entrée de l'action AssignUsertoApp
Nom du paramètre | Type de données | Obligatoire | Description |
---|---|---|---|
UserID | STRING | True | ID de l'utilisateur |
AppId | STRING | True | ID de l'application |
Pour savoir comment configurer l'action AssignUsertoApp
, consultez l'exemple pour AssignUsertoApp.
Action UnassignUsertoGroup
Cette action retire un utilisateur d'un groupe.
Paramètres d'entrée de l'action UnassignUsertoGroup
Nom du paramètre | Type de données | Obligatoire | Description |
---|---|---|---|
UserID | STRING | True | ID de l'utilisateur |
GroupID | STRING | True | ID du groupe |
Pour savoir comment configurer l'action UnassignUsertoGroup
, consultez l'exemple pour UnassignUsertoGroup.
Action UnassignUsertoApp
Cette action retire un utilisateur d'une application.
Paramètres d'entrée de l'action UnassignUsertoApp
Nom du paramètre | Type de données | Obligatoire | Description |
---|---|---|---|
UserID | STRING | True | ID de l'utilisateur |
AppID | STRING | True | ID de l'application |
Pour savoir comment configurer l'action UnassignUsertoApp
, consultez l'exemple pour UnassignUsertoApp.
Action Assigngrouptoapp
Cette action attribue un groupe à une application.
Paramètres d'entrée de l'action Assigngrouptoapp
Nom du paramètre | Type de données | Obligatoire | Description |
---|---|---|---|
GroupId | STRING | True | ID du groupe |
AppID | STRING | True | ID de l'application |
Pour savoir comment configurer l'action Assigngrouptoapp
, consultez l'exemple pour Assigngrouptoapp.
Action AssignGrouptoRole
Cette action attribue un groupe à un rôle.
Paramètres d'entrée de l'action AssignGrouptoRole
Nom du paramètre | Type de données | Obligatoire | Description |
---|---|---|---|
GroupId | STRING | True | ID du groupe |
RoleId | STRING | True | ID du rôle |
TypeId | STRING | True | ID du type |
Pour savoir comment configurer l'action AssignGrouptoRole
, consultez l'exemple pour AssignGrouptoRole.
Action UnassignGrouptoApp
Cette action retire un groupe d'une application.
Paramètres d'entrée de l'action UnassignGrouptoApp
Nom du paramètre | Type de données | Obligatoire | Description |
---|---|---|---|
Group | STRING | True | ID du groupe |
AppID | STRING | True | ID de l'application |
Pour savoir comment configurer l'action UnassignGrouptoApp
, consultez l'exemple pour UnassignGrouptoApp.
Action UnassignGrouptoRole
Cette action retire le rôle d'un groupe.
Paramètres d'entrée de l'action UnassignGrouptoRole
Nom du paramètre | Type de données | Obligatoire | Description |
---|---|---|---|
Group | STRING | True | ID du groupe |
AppID | STRING | True | ID de l'application |
Pour savoir comment configurer l'action UnassignGrouptoRole
, consultez l'exemple pour UnassignGrouptoRole.
Action SuspendUser
Cette action suspend un utilisateur.
Paramètres d'entrée de l'action SuspendUser
Nom du paramètre | Type de données | Obligatoire | Description |
---|---|---|---|
Group | STRING | True | ID du groupe |
AppID | STRING | True | ID de l'application |
Pour savoir comment configurer l'action SuspendUser
, consultez l'exemple pour SuspendUser.
Action UnsuspendUser
Cette action réactive un utilisateur.
Paramètres d'entrée de l'action UnsuspendUser
Nom du paramètre | Type de données | Obligatoire | Description |
---|---|---|---|
Group | STRING | True | ID du groupe |
AppID | STRING | True | ID de l'application |
Pour savoir comment configurer l'action UnsuspendUser
, consultez l'exemple pour UnsuspendUser.
Exemples d'actions
Exemple : Réactiver un utilisateur
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
ReactivateUser
, puis cliquez sur OK. - Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur
connectorInputPayload
, puis saisissez une valeur semblable à la suivante dans le champDefault Value
:{ "UserId": "00ulgqf2s4Zs5Ohge5d7" }
Si l'action aboutit, le paramètre de réponse connectorOutputPayload
de la tâche ReactivateUser
aura une valeur semblable à la suivante :
{ "Status": "Success", "ActivationToken": "PKeQTJMUW9vg0wyh8czA", "ActivationUrl": "https://dev-99779501.okta.com/tokens/PKeQTJMUW9vg0wyh8czA/verify" }
Exemple : Activer un utilisateur
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
ActivateUser
, puis cliquez sur OK. - Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur
connectorInputPayload
, puis saisissez une valeur semblable à la suivante dans le champDefault Value
:{ "UserId": "00ulgqf2s4Zs5Ohge5d7" }
Si l'action aboutit, le paramètre de réponse connectorOutputPayload
de la tâche ActivateUser
aura une valeur semblable à la suivante :
{ "Status": "Success", "activationurl": null, "activationtoken": null }
Exemple : Désactiver un utilisateur
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
DeactivateUser
, puis cliquez sur OK. - Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur
connectorInputPayload
, puis saisissez une valeur semblable à la suivante dans le champDefault Value
:{ "UserId": "00ulgqf2s4Zs5Ohge5d7" }
Si l'action aboutit, le paramètre de réponse connectorOutputPayload
de la tâche DeactivateUser
aura une valeur semblable à la suivante :
{ "Status": "Success", "activationurl": null, "activationtoken": null }
Exemple : Attribuer un utilisateur à un groupe
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
Assignusertogroup
, puis cliquez sur OK. - Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur
connectorInputPayload
, puis saisissez une valeur semblable à la suivante dans le champDefault Value
:{ "UserId": "00ulgqf2s4Zs5Ohge5d7", "GroupId": "7463874b834938475d" }
Si l'action aboutit, le paramètre de réponse connectorOutputPayload
de la tâche Assignusertogroup
aura une valeur semblable à la suivante :
{ "Status": "Success", }
Exemple : Retirer le rôle d'un utilisateur
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
UnassignUsertoRole
, puis cliquez sur OK. - Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur
connectorInputPayload
, puis saisissez une valeur semblable à la suivante dans le champDefault Value
:{ "UserId": "00ukxucmpl25SNLP65d7", "RoleAssignmentId": "irblawnjpom1bLBcJ5d7" }
Si l'action aboutit, le paramètre de réponse connectorOutputPayload
de la tâche UnassignUsertoRole
aura une valeur semblable à la suivante :
{ "Status": "Success", }
Exemple : Attribuer un utilisateur à un rôle
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
AssignUsertoRole
, puis cliquez sur OK. - Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur
connectorInputPayload
, puis saisissez une valeur semblable à la suivante dans le champDefault Value
:{ "UserId": "00ukxucmpl25SNLP65d7", "RoleId": "cr0l2n9ay0pCCxLgG5d7", "ResourceSet": "iaml81kep6zefR4Oq5d7", "Type": "CUSTOM" }
Si l'action aboutit, le paramètre de réponse connectorOutputPayload
de la tâche AssignUsertoRole
aura une valeur semblable à la suivante :
{ "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" }
Exemple : Attribuer un utilisateur à une application
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
AssignUsertoApp
, puis cliquez sur OK. - Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur
connectorInputPayload
, puis saisissez une valeur semblable à la suivante dans le champDefault Value
:{ "UserId": "00ukxucmpl25SNLP65d7", "AppId": "0oakn3j0bfGPR1Esk5d7" }
Si l'action aboutit, le paramètre de réponse connectorOutputPayload
de la tâche AssignUsertoApp
aura une valeur semblable à la suivante :
{ "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" }
Exemple : Retirer un utilisateur d'un groupe
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
UnassignUsertoGroup
, puis cliquez sur OK. - Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur
connectorInputPayload
, puis saisissez une valeur semblable à la suivante dans le champDefault Value
:{ "UserId": "00ukxucmpl25SNLP65d7", "GroupId": "0oakn3j0bfGPR1Esk5d7" }
Si l'action aboutit, le paramètre de réponse connectorOutputPayload
de la tâche UnassignUsertoGroup
aura une valeur semblable à la suivante :
{ "Status": "Success" }
Exemple : Retirer un utilisateur d'une application
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
UnassignUsertoApp
, puis cliquez sur OK. - Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur
connectorInputPayload
, puis saisissez une valeur semblable à la suivante dans le champDefault Value
:{ "UserId": "00ukxucmpl25SNLP65d7", "AppId": "0oakn3j0bfGPR1Esk5d7" }
Si l'action aboutit, le paramètre de réponse connectorOutputPayload
de la tâche UnassignUsertoApp
aura une valeur semblable à la suivante :
{ "Status": "Success" }
Exemple : Attribuer un groupe à une application
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
Assigngrouptoapp
, puis cliquez sur OK. - Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur
connectorInputPayload
, puis saisissez une valeur semblable à la suivante dans le champDefault Value
:{ "GroupId": "00gl5wovm8GuLr8vg5d7", "AppId": "0oakn3j0bfGPR1Esk5d7" }
Si l'action aboutit, le paramètre de réponse connectorOutputPayload
de la tâche Assigngrouptoapp
aura une valeur semblable à la suivante :
{ "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" }
Exemple : Attribuer un groupe à un rôle
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
AssignGrouptoRole
, puis cliquez sur OK. - Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur
connectorInputPayload
, puis saisissez une valeur semblable à la suivante dans le champDefault Value
:{ "GroupId": "00gl9xqojqXq0TJgS5d7", "RoleId": "cr0l5tqddvkDtcfPl5d7", "Type": "CUSTOM", "ResourceSet": "iaml81kep6zefR4Oq5d7" }
Si l'action aboutit, le paramètre de réponse connectorOutputPayload
de la tâche AssignGrouptoRole
aura une valeur semblable à la suivante :
{ "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" }
Exemple : Retirer un groupe d'une application
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
UnassignGrouptoApp
, puis cliquez sur OK. - Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur
connectorInputPayload
, puis saisissez une valeur semblable à la suivante dans le champDefault Value
:{ "GroupId": "00gl5wovm8GuLr8vg5d7", "AppId": "0oakn3j0bfGPR1Esk5d7" }
Si l'action aboutit, le paramètre de réponse connectorOutputPayload
de la tâche UnassignGrouptoApp
aura une valeur semblable à la suivante :
{ "Status": "Success" }
Exemple : Retirer le rôle d'un groupe
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
UnassignGrouptoRole
, puis cliquez sur OK. - Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur
connectorInputPayload
, puis saisissez une valeur semblable à la suivante dans le champDefault Value
:{ "GroupId": "00gl5wovm8GuLr8vg5d7", "RoleAssignmentId": "irbl94sbyit77SGpg5d7" }
Si l'action aboutit, le paramètre de réponse connectorOutputPayload
de la tâche UnassignGrouptoRole
aura une valeur semblable à la suivante :
{ "Status": "Success" }
Exemple : Suspendre un utilisateur
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
SuspendUser
, puis cliquez sur OK. - Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur
connectorInputPayload
, puis saisissez une valeur semblable à la suivante dans le champDefault Value
:{ "UserId": "00ulkdsubxO6W6LgJ5d7" }
Si l'action aboutit, le paramètre de réponse connectorOutputPayload
de la tâche SuspendUser
aura une valeur semblable à la suivante :
{ "Status": "Success" }
Exemple : Réactiver un utilisateur
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
UnsuspendUser
, puis cliquez sur OK. - Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur
connectorInputPayload
, puis saisissez une valeur semblable à la suivante dans le champDefault Value
:{ "UserId": "00ulkdsubxO6W6LgJ5d7" }
Si l'action aboutit, le paramètre de réponse connectorOutputPayload
de la tâche UnsuspendUser
aura une valeur semblable à la suivante :
{ "Status": "Success" }
Exemples d'opérations d'entité
Cette section explique comment effectuer certaines opérations d'entité dans ce connecteur.
Exemple : Lister tous les utilisateurs
- Dans la boîte de dialogue
Configure connector task
, cliquez surEntities
. - Sélectionnez "Users" dans la liste
Entity
. - Sélectionnez l'opération
List
, puis cliquez sur OK. - Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez définir la filterClause selon vos besoins.
Vous devez placer la valeur d'une clause de filtre entre des guillemets simples ('). Vous pouvez utiliser la clause de filtre pour filtrer les enregistrements en fonction des colonnes.
Exemple : Récupérer un utilisateur
- Dans la boîte de dialogue
Configure connector task
, cliquez surEntities
. - Sélectionnez
Users
dans la listeEntity
. - Sélectionnez l'opération
Get
, puis cliquez sur OK. - Définissez l'ID d'entité sur "20001", qui est la clé à transmettre. Pour définir l'ID d'entité, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez
"20001"
dans le champ Valeur d'entrée et choisissez "EntityId" comme variable locale.
Vous devez transmettre directement l'ID d'entité, par exemple "20001". Ici, "20001" est la valeur de clé primaire unique, qui est transmise.
Vous devez utiliser une clause de filtre dans les requêtes où la transmission d'un ID d'entité entraînerait une erreur, car il y aura deux clés composites, telles que id='20001'.
Exemple : Supprimer un utilisateur
- Dans la boîte de dialogue
Configure connector task
, cliquez surEntities
. - Sélectionnez
Users
dans la listeEntity
. - Sélectionnez l'opération
Delete
, puis cliquez sur OK. - Définissez l'ID d'entité sur "00ul7l5fdyTdHDfSj5d7", qui est la clé à transmettre. Pour définir l'ID d'entité, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez
"20001"
dans le champ Valeur d'entrée et choisissez "EntityId" comme variable locale.Si l'entité comporte deux clés métier ou clés primaires composites, vous pouvez définir la filterClause sur
id='00ul7l5fdyTdHDfSj5d7'
au lieu de spécifier l'entityId.
Exemple : Créer un utilisateur
- Dans la boîte de dialogue
Configure connector task
, cliquez surEntities
. - Sélectionnez
Users
dans la listeEntity
. - Sélectionnez l'opération
Create
, puis cliquez sur OK. - Dans la section Data Mapper de la tâche Mappage de données, cliquez sur
Open Data Mapping Editor
, puis saisissez une valeur semblable à la suivante dans le champInput Value
et choisissez "EntityId/ConnectorInputPayload" comme variable locale.{ "ProfileFirstName": "Test", "ProfileLastName": "Test User", "ProfileEmail": "Test@gmail.com", "ProfileLogin": "Test11@example.com" }
Si l'intégration aboutit, le paramètre de réponse
connectorOutputPayload
de la tâcheVendor
aura une valeur semblable à la suivante :{ "Id": "00ula502hjbwWYsO25d7" }
Exemple : Créer un groupe
- Dans la boîte de dialogue
Configure connector task
, cliquez surEntities
. - Sélectionnez
Groups
dans la listeEntity
. - Sélectionnez l'opération
Create
, puis cliquez sur OK. - Dans la section Data Mapper de la tâche Mappage de données, cliquez sur
Open Data Mapping Editor
, puis saisissez une valeur semblable à la suivante dans le champInput Value
et choisissez "EntityId/ConnectorInputPayload" comme variable locale.{ "ProfileDescription": "Googlecloud group", "ProfileName": "Goolecloud created grp\n" }
Si l'intégration aboutit, le paramètre de réponse
connectorOutputPayload
de la tâcheAPBill
aura une valeur semblable à la suivante :{ "Id": "00gl7lb5gniIAOMwA5d7" }
Exemple : Créer une application
- Dans la boîte de dialogue
Configure connector task
, cliquez surEntities
. - Sélectionnez
Apps
dans la listeEntity
. - Sélectionnez l'opération
Create
, puis cliquez sur OK. - Dans la section Data Mapper de la tâche Mappage de données, cliquez sur
Open Data Mapping Editor
, puis saisissez une valeur semblable à la suivante dans le champInput Value
et choisissez "EntityId/ConnectorInputPayload" comme variable locale.{ "Label": "Googlecloud generated app", "SignOnMode": "AUTO_LOGIN", "AutoSubmitToolbar": false, "Settings": "{\"signOn\":{\"redirectUrl\":\"https://www.example.com\",\"loginUrl\":\"https://www.example.com\"}}" }
Cet exemple crée le Vendtype. Si l'intégration aboutit, le paramètre de réponse
connectorOutputPayload
de la tâcheVendtype
aura une valeur semblable à la suivante :{ "Id": "0oal9vwooxEXXpdjS5d7" }
Exemple : Créer un rôle
- Dans la boîte de dialogue
Configure connector task
, cliquez surEntities
. - Sélectionnez
Roles
dans la listeEntity
. - Sélectionnez l'opération
Create
, puis cliquez sur OK. - Dans la section Data Mapper de la tâche Mappage de données, cliquez sur
Open Data Mapping Editor
, puis saisissez une valeur semblable à la suivante dans le champInput Value
et choisissez "EntityId/ConnectorInputPayload" comme variable locale.{ "Label": "new role2", "Description": "GABA Role1", "Permissions": "\"okta.users.read\", \"okta.groups.read\"" }
Si l'intégration aboutit, le paramètre de réponse
connectorOutputPayload
de la tâcheCustomer
aura une valeur semblable à la suivante :{ "Id": "cr0l824rbiTvtJDoi5d7" }
Exemple : Mettre à jour un utilisateur
- Dans la boîte de dialogue
Configure connector task
, cliquez surEntities
. - Sélectionnez
Users
dans la listeEntity
. - Sélectionnez l'opération
Update
, puis cliquez sur OK. - Dans la section Data Mapper de la tâche Mappage de données, cliquez sur
Open Data Mapping Editor
, puis saisissez une valeur semblable à la suivante dans le champInput Value
et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.{ "ProfileFirstName": "ShubhGillL" }
- Définissez l'ID d'entité dans Data Mapper sur l'entité Users. Pour définir l'ID d'entité, cliquez sur
Open Data Mapping Editor
, puis saisissez une valeur semblable à la suivante dans le champInput Value
et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur
20044
.L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie
connectorOutputPayload
de la tâche "Connecteurs" :{ "Id": "00ul7u8cyobt8SGRK5d7" }
Exemple : Mettre à jour un groupe
- Dans la boîte de dialogue
Configure connector task
, cliquez surEntities
. - Sélectionnez
Groups
dans la listeEntity
. - Sélectionnez l'opération
Update
, puis cliquez sur OK. - Dans la section Data Mapper de la tâche Mappage de données, cliquez sur
Open Data Mapping Editor
, puis saisissez une valeur semblable à la suivante dans le champInput Value
et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.{ "ProfileName": "Updated Googlecloud group" }
- Définissez l'ID d'entité dans Data Mapper sur l'entité Groups. Pour définir l'ID d'entité, cliquez sur
Open Data Mapping Editor
, puis saisissez une valeur semblable à la suivante dans le champInput Value
et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur
1371
.L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie
connectorOutputPayload
de la tâche "Connecteurs" :{ "Id": "00gl92veg4VSQQb5A5d7" }
Exemple : Mettre à jour une application
- Dans la boîte de dialogue
Configure connector task
, cliquez surEntities
. - Sélectionnez
Apps
dans la listeEntity
. - Sélectionnez l'opération
Update
, puis cliquez sur OK. - Dans la section Data Mapper de la tâche Mappage de données, cliquez sur
Open Data Mapping Editor
, puis saisissez une valeur semblable à la suivante dans le champInput Value
et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.{ "Label": "Googlecloud updated label" }
- Définissez l'ID d'entité dans Data Mapper sur l'entité Apps. Pour définir l'ID d'entité, cliquez sur
Open Data Mapping Editor
, puis saisissez une valeur semblable à la suivante dans le champInput Value
et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur
Customerid='10100'\n
.L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie
connectorOutputPayload
de la tâche "Connecteurs" :{ "Id": "0oal9vwooxEXXpdjS5d7" }
Exemple : Mettre à jour un rôle
- Dans la boîte de dialogue
Configure connector task
, cliquez surEntities
. - Sélectionnez
Roles
dans la listeEntity
. - Sélectionnez l'opération
Update
, puis cliquez sur OK. - Dans la section Data Mapper de la tâche Mappage de données, cliquez sur
Open Data Mapping Editor
, puis saisissez une valeur semblable à la suivante dans le champInput Value
et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.{ "Label": "Googlecloud updated label" }
- Définissez l'ID d'entité dans Data Mapper sur l'entité Roles. Pour définir l'ID d'entité, cliquez sur
Open Data Mapping Editor
, puis saisissez une valeur semblable à la suivante dans le champInput Value
et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur
1
.L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie
connectorOutputPayload
de la tâche "Connecteurs" :{ "Id": "cr0l7dqeatRuIrn5x5d7" }
Demander de l'aide à la communauté Google Cloud
Vous pouvez publier vos questions et discuter de ce connecteur sur les forums Cloud de la communauté Google Cloud.Étapes suivantes
- Découvrez comment suspendre et reprendre une connexion.
- Découvrez comment surveiller l'utilisation des connecteurs.
- Découvrez comment afficher les journaux des connecteurs.