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 et roles/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 :

  1. Dans la console Cloud, accédez à la page Connecteurs d'intégration > Connexions, puis sélectionnez ou créez un projet Google Cloud.

    Accéder à la page "Connexions"

  2. Cliquez sur + Créer pour ouvrir la page Créer une connexion.
  3. Dans la section Emplacement, choisissez l'emplacement de la connexion.
    1. Région : sélectionnez un emplacement dans la liste déroulante.

      Pour obtenir la liste de toutes les régions disponibles, consultez Emplacements.

    2. Cliquez sur Suivant.
  4. Dans la section Détails de connexion, procédez comme suit :
    1. Sélectionnez Okta dans la liste Connecteur.
    2. Sélectionnez une version de connecteur dans la liste Version du connecteur.
    3. 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.
    4. (Facultatif) Saisissez une description de l'instance de connexion.
    5. (Facultatif) Activez Cloud Logging, puis sélectionnez un niveau de journalisation. Par défaut, le niveau de journalisation est défini sur Error.
    6. Compte de service : sélectionnez un compte de service disposant des rôles requis.
    7. (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.

      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.

    8. Domaine : saisissez un domaine Okta pour vous connecter à l'instance Okta.
    9. (Facultatif) Cliquez sur + Ajouter une étiquette pour ajouter une étiquette à la connexion sous la forme d'une paire clé/valeur.
    10. Cliquez sur Suivant.
  5. Dans la section Authentification, saisissez les informations d'authentification.
    1. 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
    2. Pour savoir comment configurer ces types d'authentification, consultez Configurer l'authentification.

    3. Cliquez sur Suivant.
  6. Vérifier : vérifiez vos informations de connexion et d'authentification.
  7. 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 :

  1. Sur la page Connexions, recherchez la connexion que vous venez de créer.

    Notez que l'état du nouveau connecteur sera Autorisation requise.

  2. Cliquez sur Autorisation requise.

    Le volet Modifier l'autorisation s'affiche.

  3. Copiez la valeur de l'URI de redirection dans votre application externe.
  4. Vérifiez les détails de l'autorisation.
  5. 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 :

  1. Sur la page Connexions, cliquez sur la connexion requise.

    La page des détails de la connexion s'ouvre.

  2. Cliquez sur Modifier pour modifier les détails de la connexion.
  3. Dans la section Authentification, vérifiez les détails du code d'autorisation OAuth 2.0.

    Apportez des modifications, si besoin.

  4. Cliquez sur Enregistrer. La page des détails de la connexion s'affiche.
  5. Dans la section Authentification, cliquez sur Modifier l'autorisation. Le volet Autoriser s'affiche.
  6. 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action ReactivateUser, puis cliquez sur OK.
  3. 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 champ Default Value :
    {
        "UserId": "00ulgqf2s4Zs5Ohge5d7"
    }
    
  4. 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action ActivateUser, puis cliquez sur OK.
  3. 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 champ Default Value :
    {
        "UserId": "00ulgqf2s4Zs5Ohge5d7"
    }
    
    
  4. 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action DeactivateUser, puis cliquez sur OK.
  3. 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 champ Default Value :
    {
        "UserId": "00ulgqf2s4Zs5Ohge5d7"
    }
    
  4. 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action Assignusertogroup, puis cliquez sur OK.
  3. 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 champ Default Value :
    {
        "UserId": "00ulgqf2s4Zs5Ohge5d7",
        "GroupId": "7463874b834938475d"
    }
    
  4. 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action UnassignUsertoRole, puis cliquez sur OK.
  3. 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 champ Default Value :
    {
        "UserId": "00ukxucmpl25SNLP65d7",
        "RoleAssignmentId": "irblawnjpom1bLBcJ5d7"
    }
    
  4. 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action AssignUsertoRole, puis cliquez sur OK.
  3. 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 champ Default Value :
    {
    "UserId": "00ukxucmpl25SNLP65d7",
    "RoleId": "cr0l2n9ay0pCCxLgG5d7",
    "ResourceSet": "iaml81kep6zefR4Oq5d7",
    "Type": "CUSTOM"
    }
    
  4. 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action AssignUsertoApp, puis cliquez sur OK.
  3. 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 champ Default Value :
    {
        "UserId": "00ukxucmpl25SNLP65d7",
        "AppId": "0oakn3j0bfGPR1Esk5d7"
    }
    
  4. 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action UnassignUsertoGroup, puis cliquez sur OK.
  3. 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 champ Default Value :
    {
        "UserId": "00ukxucmpl25SNLP65d7",
        "GroupId": "0oakn3j0bfGPR1Esk5d7"
    }
    
  4. 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action UnassignUsertoApp, puis cliquez sur OK.
  3. 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 champ Default Value :
    {
        "UserId": "00ukxucmpl25SNLP65d7",
        "AppId": "0oakn3j0bfGPR1Esk5d7"
    }
    
    
  4. 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action Assigngrouptoapp, puis cliquez sur OK.
  3. 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 champ Default Value :
    {
       "GroupId": "00gl5wovm8GuLr8vg5d7",
        "AppId": "0oakn3j0bfGPR1Esk5d7"
    }
    
  4. 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action AssignGrouptoRole, puis cliquez sur OK.
  3. 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 champ Default Value :
    {
    "GroupId": "00gl9xqojqXq0TJgS5d7",
    "RoleId": "cr0l5tqddvkDtcfPl5d7",
    "Type": "CUSTOM", "ResourceSet": "iaml81kep6zefR4Oq5d7"
    }
    
  4. 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action UnassignGrouptoApp, puis cliquez sur OK.
  3. 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 champ Default Value :
    {
     "GroupId": "00gl5wovm8GuLr8vg5d7",
     "AppId": "0oakn3j0bfGPR1Esk5d7" 
    }
    
  4. 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action UnassignGrouptoRole, puis cliquez sur OK.
  3. 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 champ Default Value :
    {
    "GroupId": "00gl5wovm8GuLr8vg5d7",
    "RoleAssignmentId": "irbl94sbyit77SGpg5d7"
    }
    
  4. 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action SuspendUser, puis cliquez sur OK.
  3. 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 champ Default Value :
    {
    "UserId": "00ulkdsubxO6W6LgJ5d7" 
    }
    
  4. 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action UnsuspendUser, puis cliquez sur OK.
  3. 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 champ Default Value :
    {
    "UserId": "00ulkdsubxO6W6LgJ5d7" 
    }
    
  4. 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Users" dans la liste Entity.
  3. Sélectionnez l'opération List, puis cliquez sur OK.
  4. Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez définir la filterClause selon vos besoins.
  5. 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Users dans la liste Entity.
  3. Sélectionnez l'opération Get, puis cliquez sur OK.
  4. 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.
  5. 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Users dans la liste Entity.
  3. Sélectionnez l'opération Delete, puis cliquez sur OK.
  4. 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Users dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. 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 champ Input 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âche Vendor aura une valeur semblable à la suivante :

    {
        "Id": "00ula502hjbwWYsO25d7"
    }
    

Exemple : Créer un groupe

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Groups dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. 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 champ Input 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âche APBill aura une valeur semblable à la suivante :

    {
        "Id": "00gl7lb5gniIAOMwA5d7"
    }
    

Exemple : Créer une application

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Apps dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. 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 champ Input 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âche Vendtype aura une valeur semblable à la suivante :

    {
        "Id": "0oal9vwooxEXXpdjS5d7"
    }
    

Exemple : Créer un rôle

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Roles dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. 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 champ Input 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âche Customer aura une valeur semblable à la suivante :

    {
        "Id": "cr0l824rbiTvtJDoi5d7"
    }
    

Exemple : Mettre à jour un utilisateur

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Users dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. 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 champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
    {
        "ProfileFirstName": "ShubhGillL" 
    }
    
  5. 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 champ Input 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Groups dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. 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 champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
    {
        "ProfileName": "Updated Googlecloud group"
    }
    
  5. 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 champ Input 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Apps dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. 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 champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
    {
        "Label": "Googlecloud updated label"
    }
    
  5. 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 champ Input 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

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Roles dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. 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 champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
    {
        "Label": "Googlecloud updated label"
    }
    
  5. 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 champ Input 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