Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Utilizzo di utilità di amministrazione e API Edge dopo l'attivazione di SAML

Edge for Private Cloud v4.18.05

Questa sezione descrive come eseguire i comandi e gli strumenti di amministrazione di sistema di Edge dopo aver attivato SAML. Molte attività su Edge richiedono credenziali di amministratore di sistema, ad esempio:

Creazione di organizzazioni e ambienti
Aggiunta e rimozione di componenti Edge
Esecuzione dei comandi apigee-adminapi.sh

Tuttavia, dopo aver abilitato SAML su Edge, in genere disabiliti l'autenticazione di base in modo che l'unico modo per autenticarsi sia tramite l'IDP SAML. Pertanto, devi assicurarti di aver aggiunto l'account amministratore di sistema al tuo IdP SAML.

Chiamata alle API di gestione Edge come amministratore di sistema

Molte chiamate API Edge richiedono il passaggio delle credenziali dell'amministratore di sistema. Utilizzo di SAML con l'API Edge Management contiene istruzioni su come ottenere e aggiornare i token quando si effettuano chiamate all'API Edge Management.

Utilizzo dell'utilità apigee-adminapi.sh con l'autenticazione SAML

Utilizza l'utilità apigee-adminapi.sh per eseguire le stesse attività di configurazione di Edge che esegui effettuando chiamate all'API di gestione di Edge. Il vantaggio dell'utilità apigee-adminapi.sh è che:

Utilizza una semplice interfaccia a riga di comando
Implementa il completamento dei comandi basato su schede
Fornisce informazioni di assistenza e utilizzo
Può visualizzare la chiamata API corrispondente se decidi di provare l'API

Per saperne di più, consulta Utilizzo di apigee-ssoadminapi.sh.

Dopo aver attivato l'autenticazione SAML, hai diversi modi per passare le credenziali dell'amministratore di sistema all'utilità apigee-adminapi.sh.

Puoi visualizzare tutte le opzioni per qualsiasi comando apigee-adminapi.sh, incluse le opzioni per specificare le credenziali SAML, utilizzando l'opzione "-h" del comando. Ad esempio:

apigee-adminapi.sh orgs list -h

Ad esempio, puoi passare le credenziali dell'amministratore di sistema:

apigee-adminapi.sh orgs list --sso-url http://edge_sso_IP_DNS:9099 --oauth-flow password_grant \
  --admin adminEmail --oauth-password adminPword

Dove:

L'opzione sso-url specifica l'URL del modulo Edge SSO. Modifica la porta o il protocollo se li hai modificati rispetto a 9099 e HTTP.
oauth-flow specifica passcode o password_grant. In questo esempio, specifichi password_grant.
adminEmail è l'indirizzo email dell'amministratore di sistema.
oauth-password specifica la password dell'amministratore di sistema.

In alternativa, puoi utilizzare un passcode quando chiami il comando:

apigee-adminapi.sh orgs list --sso-url http://edge_sso_IP_DNS:9099 --oauth-flow passcode \
  --admin adminEmail --oauth-passcode passcode

Dove:

oauth-flow specifica passcode.
oauth-passcode specifica il passcode ottenuto da http://edge_sso_IP_DNS:9099/passcode.

Infine, puoi utilizzare un token quando chiami il comando:

apigee-adminapi.sh orgs list --sso-url http://edge_sso_IP_DNS:9099 --oauth-flow passcode \
  --admin adminEmail --oauth-token token

Dove:

oauth-flow specifica passcode o password_grant, a seconda di come hai ottenuto il token originariamente. In questo esempio, specifichi passcode perché hai ottenuto il token originariamente utilizzando get_token. Consulta Utilizzo di SAML con l'API di gestione Edge.
oauh_token contiene il token.

Utilizzo delle utilità Edge con l'autenticazione SAML

Molte utilità Edge richiedono credenziali di amministratore di sistema, ad esempio:

apigee-provision utilizzato per creare organizzazioni, ambienti e host virtuali
setup.sh utilizzato per aggiungere nodi a un sistema esistente
Qualsiasi altra utilità in cui devi specificare le credenziali dell'amministratore di sistema in un file di configurazione

Queste utilità accettano come input un file di configurazione che specifica le credenziali dell'amministratore di sistema utilizzando le proprietà:

ADMIN_EMAIL="adminEmail"
APIGEE_ADMINPW=adminPWord

Se ometti la password, ti verrà richiesto di inserirla.

Dopo aver attivato SAML, utilizzi proprietà diverse per specificare le credenziali dell'amministratore di sistema. Ad esempio, puoi passare le credenziali dell'amministratore di sistema:

ADMIN_EMAIL="adminEmail"
SSO_LOGIN_URL=http://edge_sso_IP_DNS:9099
OAUTH_FLOW=password_grant
OAUTH_ADMIN_PASSWORD=adminPWord

Dove:

SSO_LOGIN_URL specifica l'URL del modulo Edge SSO. Modifica la porta o il protocollo se li hai modificati rispetto a 9099 e HTTP.
OAUTH_FLOW specifica passcode o password_grant. In questo esempio, specifichi password_grant perché passi la password dell'amministratore di sistema.
OAUTH_ADMIN_PASSWORD specifica la password dell'amministratore di sistema.

In alternativa, puoi utilizzare le seguenti proprietà per specificare le credenziali nell'ambito di un flusso di passcode:

ADMIN_EMAIL="adminEmail"
SSO_LOGIN_URL=http://edge_sso_IP_DNS:9099
OAUTH_FLOW=passcode
OAUTH_ADMIN_PASSCODE=passcode

Dove:

OAUTH_FLOW specifica passcode.
OAUTH_ADMIN_PASSCODE specifica il passcode ottenuto da http://edge_sso_IP_DNS:9099/passcode.

Infine, puoi utilizzare un token

ADMIN_EMAIL="adminEmail"
SSO_LOGIN_URL=http://edge_sso_IP_DNS:9099
OAUTH_FLOW=passcode
OAUTH_BEARER_TOKEN=token

Dove:

OAUTH_FLOW specifica passcode o password_grant, a seconda di come hai ottenuto il token originariamente. In questo esempio, specifichi passcode perché hai ottenuto il token utilizzando get_token. Consulta Utilizzo di SAML con l'API di gestione Edge.
OAUTH_BEARER_TOKEN contiene il token.