Okta
Puoi utilizzare il connettore Okta per creare, leggere, aggiornare ed eliminare record di utenti, gruppi, ruoli e app, nonché assegnare o annullare l'assegnazione di utenti o gruppi a ruoli e applicazioni.
Prima di iniziare
Nel tuo progetto Google Cloud, svolgi le seguenti attività:
- Assicurati che la connettività di rete sia configurata. Per informazioni sui pattern di rete, consulta Connettività di rete.
- Concedi il ruolo IAM roles/connectors.admin all'utente che configura il connettore.
- Concedi i ruoli IAM
roles/secretmanager.viewereroles/secretmanager.secretAccessorall'account di servizio che vuoi utilizzare per il connettore. - Attiva i seguenti servizi:
secretmanager.googleapis.com(API Secret Manager)connectors.googleapis.com(API Connectors)
Per scoprire come attivare i servizi, consulta Abilitazione dei servizi. Se questi servizi o autorizzazioni non sono stati attivati in precedenza per il tuo progetto, ti verrà chiesto di attivarli durante la configurazione del connettore.
Creare una connessione Okta
Una connessione è specifica per un'origine dati. Ciò significa che se hai molte origini dati, devi creare una connessione distinta per ciascuna. Per creare una connessione:
- Nella console Cloud, vai alla pagina Connettori di integrazione > Connessioni e seleziona o crea un progetto Google Cloud.
- Fai clic su + Crea nuovo per aprire la pagina Crea connessione.
- Nella sezione Località, scegli la località della connessione.
- Regione: seleziona una località dall'elenco a discesa.
Per l'elenco di tutte le regioni supportate, consulta Località.
- Fai clic su Avanti.
- Regione: seleziona una località dall'elenco a discesa.
- Nella sezione Dettagli connessione, completa quanto segue:
- Seleziona Okta dall'elenco Connettore.
- Seleziona una versione del connettore dall'elenco Versione connettore.
- Nel campo Nome connessione, inserisci un nome per l'istanza di connessione. Il nome della connessione può contenere lettere minuscole, numeri o trattini. Il nome deve iniziare con una lettera e terminare con una lettera o un numero e non deve superare i 49 caratteri.
- (Facoltativo) Inserisci una Descrizione per l'istanza di connessione.
- Se vuoi, attiva Cloud Logging e poi seleziona un livello di log. Per impostazione predefinita, il livello di log è impostato su
Error. - Account di servizio: seleziona un account di servizio con i ruoli richiesti.
- (Facoltativo) Configura le impostazioni del nodo di connessione.
- Numero minimo di nodi: inserisci il numero minimo di nodi di connessione.
- Numero massimo di nodi: inserisci il numero massimo di nodi di connessione.
- Dominio: inserisci un dominio Okta a cui connetterti all'istanza Okta.
- Se vuoi, fai clic su + Aggiungi etichetta per aggiungere un'etichetta alla connessione sotto forma di coppia chiave/valore.
- Fai clic su Avanti.
Un nodo è un'unità (o una replica) di una connessione che elabora le transazioni. Sono necessari più nodi per elaborare più transazioni per una connessione e, al contrario, sono necessari meno nodi per elaborare meno transazioni. Per capire in che modo i nodi influiscono sui prezzi dei connettori, consulta Prezzi per i nodi di connessione. Se non inserisci alcun valore, per impostazione predefinita i nodi minimi sono impostati su 2 (per una maggiore disponibilità) e i nodi massimi su 50.
-
Nella sezione Autenticazione, inserisci i dettagli di autenticazione.
- Seleziona un Tipo di autenticazione e inserisci i dettagli pertinenti.
La connessione Okta supporta i seguenti tipi di autenticazione:
- OAuth 2.0 - Codice di autorizzazione
- Credenziali client OAuth 2.0 con token JWT
- Fai clic su Avanti.
Per capire come configurare questi tipi di autenticazione, consulta Configurare l'autenticazione.
- Seleziona un Tipo di autenticazione e inserisci i dettagli pertinenti.
- Rivedi: controlla i dettagli di connessione e autenticazione.
- Fai clic su Crea.
Configura autenticazione
Inserisci i dettagli in base all'autenticazione che vuoi utilizzare.
-
OAuth 2.0 - Codice di autorizzazione
- ID client: l'ID client utilizzato per richiedere i token di accesso.
- Ampiezze: un elenco separato da virgole degli ambiti desiderati.
- Client secret: il client secret utilizzato per richiedere i token di accesso.
- URL di autorizzazione: l'URL di autorizzazione generato durante la creazione del client.
Per il tipo di autenticazione Authorization code, dopo aver creato la connessione, devi eseguire alcuni passaggi aggiuntivi per configurare l'autenticazione. Per ulteriori informazioni, consulta la sezione Passaggi aggiuntivi dopo la creazione della connessione.
-
OAuth 2.0 - Credenziali client con JWT bearer
- ID client: l'ID client utilizzato per richiedere i token di accesso.
- Ampiezze: un elenco separato da virgole degli ambiti desiderati.
- Chiave privata: il secret di Secret Manager contenente i contenuti del file della chiave privata in formato PEM. La chiave privata deve corrispondere alla chiave pubblica/al certificato.
Passaggi aggiuntivi dopo la creazione della connessione
Se hai selezionato OAuth 2.0 - Authorization code per
l'autenticazione, devi eseguire i seguenti passaggi aggiuntivi dopo aver creato la connessione:
- Nella pagina Connessioni,
individua la connessione appena creata.
Tieni presente che lo stato del nuovo connettore sarà Autorizzazione richiesta.
- Fai clic su Autorizzazione obbligatoria.
Viene visualizzato il riquadro Modifica autorizzazione.
- Copia il valore URI di reindirizzamento nell'applicazione esterna.
- Verifica i dettagli dell'autorizzazione.
- Fai clic su Autorizza.
Se l'autorizzazione va a buon fine, lo stato della connessione verrà impostato su Attivo nella pagina Connessioni.
Nuova autorizzazione per il codice di autorizzazione
Se utilizzi il tipo di autenticazione Authorization code e hai apportato modifiche alla configurazione,
devi autorizzare di nuovo la connessione a Okta. Per autorizzare di nuovo una connessione:
- Fai clic sulla connessione richiesta nella pagina Connections (Connessioni).
Verrà aperta la pagina dei dettagli della connessione.
- Fai clic su Modifica per modificare i dettagli della connessione.
- Verifica i dettagli di OAuth 2.0 - Codice di autorizzazione nella sezione Autenticazione.
Se necessario, apporta le modifiche necessarie.
- Fai clic su Salva. Viene visualizzata la pagina dei dettagli della connessione.
- Fai clic su Modifica autorizzazione nella sezione Autenticazione. Viene visualizzato il riquadro Autorizza.
- Fai clic su Autorizza.
Se l'autorizzazione va a buon fine, lo stato della connessione verrà impostato su Attivo nella pagina Connessioni.
Limitazioni del sistema
Il connettore Okta può elaborare un massimo di una transazione al secondo per nodo e limita le transazioni che superano questo limite. Per impostazione predefinita, Integration Connectors alloca 2 nodi (per una maggiore disponibilità) per una connessione.
Per informazioni sui limiti applicabili a Integration Connectors, vedi Limiti.
Utilizzare la connessione Okta in un'integrazione
Una volta creata, la connessione diventa disponibile sia nell'integrazione Apigee sia nell'integrazione delle applicazioni. Puoi utilizzare la connessione in un'integrazione tramite l'attività Connettori.
- Per informazioni su come creare e utilizzare l'attività Connectors in Apigee Integration, consulta Attività Connectors.
- Per informazioni su come creare e utilizzare l'attività Connettori in Application Integration, consulta Attività Connettori.
Azioni
Questa sezione elenca le azioni supportate dal connettore Okta. Per capire come configurare le azioni, consulta Esempi di azioni.
Azione ReactivateUser
Questa azione riattiva un utente.
Parametri di input dell'azione ReactivateUser
| Nome parametro | Tipo di dati | Obbligatorio | Descrizione |
|---|---|---|---|
| UserID | Stringa | Vero | L'ID dell'utente. |
Per un esempio su come configurare l'azione ReactivateUser, consulta Esempio di ActivateUser.
Azione ActivateUser
Questa azione attiva un utente.
Parametri di input dell'azione ActivateUser
| Nome parametro | Tipo di dati | Obbligatorio | Descrizione |
|---|---|---|---|
| UserID | Stringa | Vero | L'ID dell'utente. |
Per un esempio su come configurare l'azione ActivateUser, consulta Esempio di ActivateUser.
Azione DeactivateUser
Questa azione disattiva un utente.
Parametri di input dell'azione DeactivateUser
| Nome parametro | Tipo di dati | Obbligatorio | Descrizione |
|---|---|---|---|
| UserID | Stringa | Vero | L'ID dell'utente. |
Per un esempio su come configurare l'azione DeactivateUser, consulta Esempio di disattivazione utente.
Azione Assignusertogroup
Questa azione assegna un utente a un gruppo.
Parametri di input dell'azione Assignusertogroup
| Nome parametro | Tipo di dati | Obbligatorio | Descrizione |
|---|---|---|---|
| UserID | Stringa | Vero | L'ID dell'utente. |
| GroupID | Stringa | Vero | L'ID del gruppo. |
Ad esempio, per informazioni su come configurare l'azione Assignusertogroup, consulta Esempio di assegnazione utente a gruppo.
Azione UnassignUsertoRole
Questa azione annulla l'assegnazione di un utente a un ruolo.
Parametri di input dell'azione UnassignUsertoRole
| Nome parametro | Tipo di dati | Obbligatorio | Descrizione |
|---|---|---|---|
| UserID | Stringa | Vero | L'ID dell'utente. |
| RoleAssignmentId | Stringa | Vero | L'ID del ruolo. |
Ad esempio, per informazioni su come configurare l'azione UnassignUsertoRole, consulta Esempio di UnassignUsertoRole.
Azione AssignUsertoRole
Questa azione assegna un utente a un ruolo.
Parametri di input dell'azione AssignUsertoRole
| Nome parametro | Tipo di dati | Obbligatorio | Descrizione |
|---|---|---|---|
| UserID | Stringa | Vero | L'ID dell'utente. |
| RoleId | Stringa | Vero | L'ID del ruolo. |
Ad esempio, per informazioni su come configurare l'azione AssignUsertoRole, consulta Esempio di assegnazione dell'utente al ruolo.
Azione AssignUsertoApp
Questa azione assegna un utente a un'app.
Parametri di input dell'azione AssignUsertoApp
| Nome parametro | Tipo di dati | Obbligatorio | Descrizione |
|---|---|---|---|
| UserID | Stringa | Vero | L'ID dell'utente. |
| AppId | Stringa | Vero | L'ID dell'app. |
Ad esempio, per scoprire come configurare l'azione AssignUsertoApp, consulta AssignUsertoApp Example.
Azione UnassignUsertoGroup
Questa azione annulla l'assegnazione di un utente a un gruppo.
Parametri di input dell'azione UnassignUsertoGroup
| Nome parametro | Tipo di dati | Obbligatorio | Descrizione |
|---|---|---|---|
| UserID | Stringa | Vero | L'ID dell'utente. |
| GroupID | Stringa | Vero | L'ID del gruppo. |
Per esempio, su come configurare l'azione UnassignUsertoGroup, consulta Esempio di UnassignUsertoGroup.
Azione UnassignUsertoApp
Questa azione annulla l'assegnazione di un utente a un'app.
Parametri di input dell'azione UnassignUsertoApp
| Nome parametro | Tipo di dati | Obbligatorio | Descrizione |
|---|---|---|---|
| UserID | Stringa | Vero | L'ID dell'utente. |
| AppID | Stringa | Vero | L'ID dell'app. |
Ad esempio, per scoprire come configurare l'azione UnassignUsertoApp, consulta Esempio di UnassignUsertoApp.
Azione Assigngrouptoapp
Questa azione assegna un gruppo a un'app.
Parametri di input dell'azione Assigngrouptoapp
| Nome parametro | Tipo di dati | Obbligatorio | Descrizione |
|---|---|---|---|
| GroupId | Stringa | Vero | L'ID del gruppo. |
| AppID | Stringa | Vero | L'ID dell'app. |
Ad esempio, per informazioni su come configurare l'azione Assigngrouptoapp, consulta Esempio di assegnazione di un gruppo all'app.
Azione AssignGrouptoRole
Questa azione assegna un gruppo a un ruolo.
Parametri di input dell'azione AssignGrouptoRole
| Nome parametro | Tipo di dati | Obbligatorio | Descrizione |
|---|---|---|---|
| GroupId | Stringa | Vero | L'ID del gruppo |
| RoleId | Stringa | Vero | L'ID del ruolo |
| TypeId | Stringa | Vero | L'ID del tipo |
Ad esempio, per informazioni su come configurare l'azione AssignGrouptoRole, consulta AssignGrouptoRole Example (Esempio di assegnazione del gruppo al ruolo).
Azione UnassignGrouptoApp
Questa azione annulla l'assegnazione di un gruppo a un'app.
Parametri di input dell'azione UnassignGrouptoApp
| Nome parametro | Tipo di dati | Obbligatorio | Descrizione |
|---|---|---|---|
| Gruppo | Stringa | Vero | L'ID di GroupId |
| AppID | Stringa | Vero | L'ID dell'app |
Ad esempio, per sapere come configurare l'azione UnassignGrouptoApp, consulta Esempio di annullamento dell'assegnazione del gruppo all'app.
Azione UnassignGrouptoRole
Questa azione annulla l'assegnazione di un gruppo a un ruolo.
Parametri di input dell'azione UnassignGrouptoRole
| Nome parametro | Tipo di dati | Obbligatorio | Descrizione |
|---|---|---|---|
| Gruppo | Stringa | Vero | L'ID di GroupId |
| AppID | Stringa | Vero | L'ID di AppId |
Ad esempio, per informazioni su come configurare l'azione UnassignGrouptoRole, consulta Esempio di sassegnazione del gruppo al ruolo.
Azione SuspendUser
Questa azione sospende un utente.
Parametri di input dell'azione SuspendUser
| Nome parametro | Tipo di dati | Obbligatorio | Descrizione |
|---|---|---|---|
| Gruppo | Stringa | Vero | L'ID di GroupId. |
| AppID | Stringa | Vero | L'ID di AppId. |
Per un esempio su come configurare l'azione SuspendUser, consulta Esempio di sospensione utente.
Azione UnsuspendUser
Questa azione annulla la sospensione di un utente.
Parametri di input dell'azione UnsuspendUser
| Nome parametro | Tipo di dati | Obbligatorio | Descrizione |
|---|---|---|---|
| Gruppo | Stringa | Vero | L'ID di GroupId. |
| AppID | Stringa | Vero | L'ID di AppId. |
Per un esempio su come configurare l'azione UnsuspendUser, consulta Esempio di UnsuspendUser.
Esempi di azioni
Esempio: riattivare un utente
- Nella finestra di dialogo
Configure connector task, fai clic suActions. - Seleziona l'azione
ReactivateUsere poi fai clic su Fine. - Nella sezione Input attività dell'attività Connettori, fai clic su
connectorInputPayloade inserisci un valore simile al seguente nel campoDefault Value:{ "UserId": "00ulgqf2s4Zs5Ohge5d7" }
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task ReactivateUser avrà un valore simile al seguente:
{
"Status": "Success",
"ActivationToken": "PKeQTJMUW9vg0wyh8czA",
"ActivationUrl": "https://dev-99779501.okta.com/tokens/PKeQTJMUW9vg0wyh8czA/verify"
}
Esempio: attivare un utente
- Nella finestra di dialogo
Configure connector task, fai clic suActions. - Seleziona l'azione
ActivateUsere poi fai clic su Fine. - Nella sezione Input attività dell'attività Connettori, fai clic su
connectorInputPayloade inserisci un valore simile al seguente nel campoDefault Value:{ "UserId": "00ulgqf2s4Zs5Ohge5d7" }
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task ActivateUser avrà un valore simile al seguente:
{
"Status": "Success",
"activationurl": null,
"activationtoken": null
}
Esempio: disattivare un utente
- Nella finestra di dialogo
Configure connector task, fai clic suActions. - Seleziona l'azione
DeactivateUsere poi fai clic su Fine. - Nella sezione Input attività dell'attività Connettori, fai clic su
connectorInputPayloade inserisci un valore simile al seguente nel campoDefault Value:{ "UserId": "00ulgqf2s4Zs5Ohge5d7" }
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task DeactivateUser avrà un valore simile al seguente:
{
"Status": "Success",
"activationurl": null,
"activationtoken": null
}
Esempio: assegnazione di un utente a un gruppo
- Nella finestra di dialogo
Configure connector task, fai clic suActions. - Seleziona l'azione
Assignusertogroupe poi fai clic su Fine. - Nella sezione Input attività dell'attività Connettori, fai clic su
connectorInputPayloade poi inserisci un valore simile al seguente nel campoDefault Value:{ "UserId": "00ulgqf2s4Zs5Ohge5d7", "GroupId": "7463874b834938475d" }
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task Assignusertogroup avrà un valore simile al seguente:
{
"Status": "Success",
}
Esempio: annullare l'assegnazione di un utente a un ruolo
- Nella finestra di dialogo
Configure connector task, fai clic suActions. - Seleziona l'azione
UnassignUsertoRolee poi fai clic su Fine. - Nella sezione Input attività dell'attività Connettori, fai clic su
connectorInputPayloade poi inserisci un valore simile al seguente nel campoDefault Value:{ "UserId": "00ukxucmpl25SNLP65d7", "RoleAssignmentId": "irblawnjpom1bLBcJ5d7" }
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task UnassignUsertoRole avrà un valore simile al seguente:
{
"Status": "Success",
}
Esempio: assegnazione di un utente a un ruolo
- Nella finestra di dialogo
Configure connector task, fai clic suActions. - Seleziona l'azione
AssignUsertoRolee poi fai clic su Fine. - Nella sezione Input attività dell'attività Connettori, fai clic su
connectorInputPayloade inserisci un valore simile al seguente nel campoDefault Value:{ "UserId": "00ukxucmpl25SNLP65d7", "RoleId": "cr0l2n9ay0pCCxLgG5d7", "ResourceSet": "iaml81kep6zefR4Oq5d7", "Type": "CUSTOM" }
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task AssignUsertoRole avrà un valore simile al seguente:
{
"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"
}
Esempio: assegnazione di un utente a un'app
- Nella finestra di dialogo
Configure connector task, fai clic suActions. - Seleziona l'azione
AssignUsertoAppe poi fai clic su Fine. - Nella sezione Input attività dell'attività Connettori, fai clic su
connectorInputPayloade inserisci un valore simile al seguente nel campoDefault Value:{ "UserId": "00ukxucmpl25SNLP65d7", "AppId": "0oakn3j0bfGPR1Esk5d7" }
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task AssignUsertoApp avrà un valore simile al seguente:
{
"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"
}
Esempio: annullare l'assegnazione di un utente a un gruppo
- Nella finestra di dialogo
Configure connector task, fai clic suActions. - Seleziona l'azione
UnassignUsertoGroupe poi fai clic su Fine. - Nella sezione Input attività dell'attività Connettori, fai clic su
connectorInputPayloade inserisci un valore simile al seguente nel campoDefault Value:{ "UserId": "00ukxucmpl25SNLP65d7", "GroupId": "0oakn3j0bfGPR1Esk5d7" }
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task UnassignUsertoGroup avrà un valore simile al seguente:
{
"Status": "Success"
}
Esempio: annullare l'assegnazione di un utente a un'app
- Nella finestra di dialogo
Configure connector task, fai clic suActions. - Seleziona l'azione
UnassignUsertoAppe poi fai clic su Fine. - Nella sezione Input attività dell'attività Connettori, fai clic su
connectorInputPayloade poi inserisci un valore simile al seguente nel campoDefault Value:{ "UserId": "00ukxucmpl25SNLP65d7", "AppId": "0oakn3j0bfGPR1Esk5d7" }
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task UnassignUsertoApp avrà un valore simile al seguente:
{
"Status": "Success"
}
Esempio: assegnazione di un gruppo a un'app
- Nella finestra di dialogo
Configure connector task, fai clic suActions. - Seleziona l'azione
Assigngrouptoappe poi fai clic su Fine. - Nella sezione Input attività dell'attività Connettori, fai clic su
connectorInputPayloade poi inserisci un valore simile al seguente nel campoDefault Value:{ "GroupId": "00gl5wovm8GuLr8vg5d7", "AppId": "0oakn3j0bfGPR1Esk5d7" }
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task Assigngrouptoapp avrà un valore simile al seguente:
{
"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"
}
Esempio: assegnazione di un gruppo a un ruolo
- Nella finestra di dialogo
Configure connector task, fai clic suActions. - Seleziona l'azione
AssignGrouptoRolee poi fai clic su Fine. - Nella sezione Input attività dell'attività Connettori, fai clic su
connectorInputPayloade poi inserisci un valore simile al seguente nel campoDefault Value:{ "GroupId": "00gl9xqojqXq0TJgS5d7", "RoleId": "cr0l5tqddvkDtcfPl5d7", "Type": "CUSTOM", "ResourceSet": "iaml81kep6zefR4Oq5d7" }
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task AssignGrouptoRole avrà un valore simile al seguente:
{
"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"
}
Esempio: annullare l'assegnazione di un gruppo a un'app
- Nella finestra di dialogo
Configure connector task, fai clic suActions. - Seleziona l'azione
UnassignGrouptoAppe poi fai clic su Fine. - Nella sezione Input attività dell'attività Connettori, fai clic su
connectorInputPayloade poi inserisci un valore simile al seguente nel campoDefault Value:{ "GroupId": "00gl5wovm8GuLr8vg5d7", "AppId": "0oakn3j0bfGPR1Esk5d7" }
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task UnassignGrouptoApp avrà un valore simile al seguente:
{
"Status": "Success"
}
Esempio: annullare l'assegnazione di un gruppo a un ruolo
- Nella finestra di dialogo
Configure connector task, fai clic suActions. - Seleziona l'azione
UnassignGrouptoRolee poi fai clic su Fine. - Nella sezione Input attività dell'attività Connettori, fai clic su
connectorInputPayloade poi inserisci un valore simile al seguente nel campoDefault Value:{ "GroupId": "00gl5wovm8GuLr8vg5d7", "RoleAssignmentId": "irbl94sbyit77SGpg5d7" }
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task UnassignGrouptoRole avrà un valore simile al seguente:
{
"Status": "Success"
}
Esempio: sospendere un utente
- Nella finestra di dialogo
Configure connector task, fai clic suActions. - Seleziona l'azione
SuspendUsere poi fai clic su Fine. - Nella sezione Input attività dell'attività Connettori, fai clic su
connectorInputPayloade inserisci un valore simile al seguente nel campoDefault Value:{ "UserId": "00ulkdsubxO6W6LgJ5d7" }
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task SuspendUser avrà un valore simile al seguente:
{
"Status": "Success"
}
Esempio: annullare la sospensione di un utente
- Nella finestra di dialogo
Configure connector task, fai clic suActions. - Seleziona l'azione
UnsuspendUsere poi fai clic su Fine. - Nella sezione Input attività dell'attività Connettori, fai clic su
connectorInputPayloade poi inserisci un valore simile al seguente nel campoDefault Value:{ "UserId": "00ulkdsubxO6W6LgJ5d7" }
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task UnsuspendUser avrà un valore simile al seguente:
{
"Status": "Success"
}
Esempi di operazioni sulle entità
Questa sezione mostra come eseguire alcune delle operazioni sulle entità in questo connettore.
Esempio: elenca tutti gli utenti
- Nella finestra di dialogo
Configure connector task, fai clic suEntities. - Seleziona Utenti dall'elenco
Entity. - Seleziona l'operazione
Liste poi fai clic su Fine. - Nella sezione Input dell'attività dell'attività Connettori, puoi impostare filterClause in base alle tue esigenze.
Devi utilizzare virgolette singole (") per racchiudere il valore di una clausola di filtro. Puoi utilizzare la clausola filtro per filtrare i record in base alle colonne.
Esempio: ottieni un utente
- Nella finestra di dialogo
Configure connector task, fai clic suEntities. - Seleziona
Usersdall'elencoEntity. - Seleziona l'operazione
Gete poi fai clic su Fine. - Imposta l'ID entità su "20001", che è la chiave da passare. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dei dati, fai clic su Apri editor di mappatura dei dati e poi inserisci
"20001"nel campo Valore di input e scegli EntityId come variabile locale.
Devi passare direttamente l'ID entità, ad esempio "20001". Qui, "20001" è il valore della chiave primaria univoca, che viene passato
Devi utilizzare la clausola di filtro nelle query in cui il passaggio di un ID entità genera un errore perché ci saranno due chiavi composite, ad esempio id='20001'
Esempio: eliminare un utente
- Nella finestra di dialogo
Configure connector task, fai clic suEntities. - Seleziona
Usersdall'elencoEntity. - Seleziona l'operazione
Deletee poi fai clic su Fine. - Imposta l'ID entità su "00ul7l5fdyTdHDfSj5d7", che è la chiave da passare.Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dei dati, fai clic su Apri editor di mappatura dei dati e poi inserisci
"20001"nel campo Valore di input e scegli EntityId come variabile locale.Se l'entità ha due chiavi principali o aziendali composite anziché specificare entityId, puoi anche impostare filterClause su
id='00ul7l5fdyTdHDfSj5d7'.
Esempio: crea un utente
- Nella finestra di dialogo
Configure connector task, fai clic suEntities. - Seleziona
Usersdall'elencoEntity. - Seleziona l'operazione
Createe fai clic su Fine. - Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su
Open Data Mapping Editor, quindi inserisci un valore simile al seguente nelInput Valuecampo e scegli EntityId/ConnectorInputPayload come variabile locale.{ "ProfileFirstName": "Test", "ProfileLastName": "Test User", "ProfileEmail": "Test@gmail.com", "ProfileLogin": "Test11@example.com" }Se l'integrazione è riuscita, il parametro di risposta
connectorOutputPayloaddella taskVendoravrà un valore simile al seguente:{ "Id": "00ula502hjbwWYsO25d7" }
Esempio: crea un gruppo
- Nella finestra di dialogo
Configure connector task, fai clic suEntities. - Seleziona
Groupsdall'elencoEntity. - Seleziona l'operazione
Createe fai clic su Fine. - Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su
Open Data Mapping Editor, quindi inserisci un valore simile al seguente nelInput Valuecampo e scegli EntityId/ConnectorInputPayload come variabile locale.{ "ProfileDescription": "Googlecloud group", "ProfileName": "Goolecloud created grp\n" }Se l'integrazione è riuscita, il parametro di risposta
connectorOutputPayloaddella taskAPBillavrà un valore simile al seguente:{ "Id": "00gl7lb5gniIAOMwA5d7" }
Esempio: crea un'app
- Nella finestra di dialogo
Configure connector task, fai clic suEntities. - Seleziona
Appsdall'elencoEntity. - Seleziona l'operazione
Createe fai clic su Fine. - Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su
Open Data Mapping Editor, quindi inserisci un valore simile al seguente nelInput Valuecampo e scegli EntityId/ConnectorInputPayload come variabile locale.{ "Label": "Googlecloud generated app", "SignOnMode": "AUTO_LOGIN", "AutoSubmitToolbar": false, "Settings": "{\"signOn\":{\"redirectUrl\":\"https://www.example.com\",\"loginUrl\":\"https://www.example.com\"}}" }Questo esempio crea il campo Vendtype. Se l'integrazione è riuscita, il parametro di risposta
connectorOutputPayloaddella taskVendtypeavrà un valore simile al seguente:{ "Id": "0oal9vwooxEXXpdjS5d7" }
Esempio: creare un ruolo
- Nella finestra di dialogo
Configure connector task, fai clic suEntities. - Seleziona
Rolesdall'elencoEntity. - Seleziona l'operazione
Createe fai clic su Fine. - Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su
Open Data Mapping Editor, quindi inserisci un valore simile al seguente nelInput Valuecampo e scegli EntityId/ConnectorInputPayload come variabile locale.{ "Label": "new role2", "Description": "GABA Role1", "Permissions": "\"okta.users.read\", \"okta.groups.read\"" }Se l'integrazione è riuscita, il parametro di risposta
connectorOutputPayloaddella taskCustomeravrà un valore simile al seguente:{ "Id": "cr0l824rbiTvtJDoi5d7" }
Esempio: aggiornare un utente
- Nella finestra di dialogo
Configure connector task, fai clic suEntities. - Seleziona
Usersdall'elencoEntity. - Seleziona l'operazione
Updatee fai clic su Fine. - Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su
Open Data Mapping Editor, quindi inserisci un valore simile al seguente nelInput Valuecampo e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.{ "ProfileFirstName": "ShubhGillL" } - Imposta l'ID entità in Data Mapper sull'entità degli utenti. Per impostare l'ID entità, fai clic su
Open Data Mapping Editor, quindi inserisci un valore simile al seguente nelInput Valuecampo e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.Anziché specificare entityId, puoi anche impostare filterClause su
20044.L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output
connectorOutputPayloaddel compito del connettore:{ "Id": "00ul7u8cyobt8SGRK5d7" }
Esempio: aggiorna un gruppo
- Nella finestra di dialogo
Configure connector task, fai clic suEntities. - Seleziona
Groupsdall'elencoEntity. - Seleziona l'operazione
Updatee fai clic su Fine. - Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su
Open Data Mapping Editor, quindi inserisci un valore simile al seguente nelInput Valuecampo e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.{ "ProfileName": "Updated Googlecloud group" } - Imposta l'ID entità in Data Mapper sull'entità dei gruppi. Per impostare l'ID entità, fai clic su
Open Data Mapping Editor, quindi inserisci un valore simile al seguente nelInput Valuecampo e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.Anziché specificare entityId, puoi anche impostare filterClause su
1371.L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output
connectorOutputPayloaddel compito del connettore:{ "Id": "00gl92veg4VSQQb5A5d7" }
Esempio: aggiornare un'app
- Nella finestra di dialogo
Configure connector task, fai clic suEntities. - Seleziona
Appsdall'elencoEntity. - Seleziona l'operazione
Updatee fai clic su Fine. - Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su
Open Data Mapping Editor, poi inserisci un valore simile al seguente nel campoInput Valuee scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.{ "Label": "Googlecloud updated label" } - Imposta l'ID entità in Data Mapper sull'entità delle app. Per impostare l'ID entità, fai clic su
Open Data Mapping Editor, quindi inserisci un valore simile al seguente nelInput Valuecampo e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.Anziché specificare entityId, puoi anche impostare filterClause su
Customerid='10100'\n.L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output
connectorOutputPayloaddel compito del connettore:{ "Id": "0oal9vwooxEXXpdjS5d7" }
Esempio: aggiorna un ruolo
- Nella finestra di dialogo
Configure connector task, fai clic suEntities. - Seleziona
Rolesdall'elencoEntity. - Seleziona l'operazione
Updatee fai clic su Fine. - Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su
Open Data Mapping Editor, quindi inserisci un valore simile al seguente nelInput Valuecampo e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.{ "Label": "Googlecloud updated label" } - Imposta l'ID entità in Data Mapper sull'entità dei ruoli. Per impostare l'ID entità, fai clic su
Open Data Mapping Editor, quindi inserisci un valore simile al seguente nelInput Valuecampo e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.Anziché specificare entityId, puoi anche impostare filterClause su
1.L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output
connectorOutputPayloaddel compito del connettore:{ "Id": "cr0l7dqeatRuIrn5x5d7" }
Ricevere assistenza dalla community Google Cloud
Puoi pubblicare le tue domande e discutere di questo connettore nella community di Google Cloud ai forum di Cloud.Passaggi successivi
- Scopri come sospendere e riprendere una connessione.
- Scopri come monitorare l'utilizzo dei connettori.
- Scopri come visualizzare i log del connettore.