Edge para nuvem privada v4.19.01
Nesta seção, descrevemos como executar ferramentas e comandos de administrador do sistema do Edge depois de ativar o SAML. Muitas tarefas no Edge exigem credenciais de administração do sistema, como:
- Como criar organizações e ambientes
- Como adicionar e remover componentes do Edge
- Como executar comandos apigee-adminapi.sh
No entanto, depois de ativar o SAML no Edge, você normalmente desativa a autenticação básica para que a única maneira de autenticar seja pelo IDP do SAML. Portanto, verifique se você adicionou a conta de administrador do sistema ao IdP SAML.
Como chamar APIs de gerenciamento da borda como administrador do sistema
Muitas chamadas de API Edge exigem que você transmita credenciais de administrador do sistema. Como usar o SAML com a API Edge Management contém instruções sobre como receber e atualizar tokens ao fazer chamadas de API Edge Management.
Como usar o utilitário apigee-adminapi.sh com autenticação SAML
Use o utilitário apigee-adminapi.sh para executar as mesmas tarefas de configuração do Edge
que você realiza fazendo chamadas para a API de gerenciamento do Edge. A vantagem do utilitário apigee-adminapi.sh é que ele:
- Usar uma interface de linha de comando simples
- Implementa o preenchimento de comandos com tabulação
- Fornece informações de ajuda e uso
- Pode exibir a chamada de API correspondente se você decidir testar a API.
Para mais informações, consulte Como usar apigee-ssoadminapi.sh.
Depois de ativar a autenticação SAML, você tem várias maneiras de transmitir as credenciais de administrador do sistema
para o utilitário apigee-adminapi.sh.
É possível ver todas as opções de qualquer comando apigee-adminapi.sh, incluindo as
opções para especificar credenciais SAML, usando a opção "-h" no comando. Por
exemplo:
apigee-adminapi.sh orgs list -h
Por exemplo, é possível transmitir as credenciais de administrador do sistema:
apigee-adminapi.sh orgs list --sso-url http://edge_sso_IP_DNS:9099 --oauth-flow password_grant \ --admin adminEmail --oauth-password adminPword
Em que:
- A opção
sso-urlespecifica o URL do módulo de SSO do Edge. Modifique a porta ou o protocolo se você tiver alterado 9099 e HTTP. oauth-flowespecificapasscodeoupassword_grant. Neste exemplo, especifiquepassword_grant.- adminEmail é o endereço de e-mail do administrador do sistema.
oauth-passwordespecifica a senha do administrador do sistema.
Como alternativa, use uma senha ao chamar o comando:
apigee-adminapi.sh orgs list --sso-url http://edge_sso_IP_DNS:9099 --oauth-flow passcode \ --admin adminEmail --oauth-passcode passcode
Em que:
oauth-flowespecificapasscode.oauth-passcodeespecifica a senha obtida dehttp://edge_sso_IP_DNS:9099/passcode.
Por fim, use um token ao chamar o comando:
apigee-adminapi.sh orgs list --sso-url http://edge_sso_IP_DNS:9099 --oauth-flow passcode \ --admin adminEmail --oauth-token token
Em que:
oauth-flowespecificapasscodeoupassword_grant, dependendo de como você recebeu o token originalmente. Neste exemplo, você especificapasscodeporque recebeu o token originalmente usandoget_token. Consulte Como usar o SAML com a API Management do Edge.oauh_tokencontém o token.
Como usar utilitários do Edge com autenticação SAML
Muitos utilitários do Edge exigem credenciais de administrador do sistema, como:
apigee-provisionusado para criar organizações, ambientes e hosts virtuaissetup.shusado para adicionar nós a um sistema atual- Qualquer outro utilitário em que você precise especificar as credenciais de administrador do sistema em um arquivo de configuração
Esses utilitários usam como entrada um arquivo de configuração que especifica as credenciais do administrador do sistema usando as propriedades:
ADMIN_EMAIL="adminEmail" APIGEE_ADMINPW=adminPWord
Se você omitir a senha, ela será solicitada.
Depois de ativar o SAML, use propriedades diferentes para especificar as credenciais do administrador do sistema. Por exemplo, é possível transmitir as credenciais de administrador do sistema:
ADMIN_EMAIL="adminEmail" SSO_LOGIN_URL=http://edge_sso_IP_DNS:9099 OAUTH_FLOW=password_grant OAUTH_ADMIN_PASSWORD=adminPWord
Em que:
SSO_LOGIN_URLespecifica o URL do módulo de SSO do Edge. Modifique a porta ou o protocolo se você os tiver alterado de 9099 e HTTP.OAUTH_FLOWespecificapasscodeoupassword_grant. Neste exemplo, você especificapassword_grantporque está transmitindo a senha do administrador do sistema.OAUTH_ADMIN_PASSWORDespecifica a senha do administrador do sistema.
Como alternativa, é possível usar as seguintes propriedades para especificar as credenciais como parte de um fluxo de senha:
ADMIN_EMAIL="adminEmail" SSO_LOGIN_URL=http://edge_sso_IP_DNS:9099 OAUTH_FLOW=passcode OAUTH_ADMIN_PASSCODE=passcode
Em que:
OAUTH_FLOWespecificapasscode.OAUTH_ADMIN_PASSCODEespecifica a senha obtida dehttp://edge_sso_IP_DNS:9099/passcode.
Por fim, é possível usar um token
ADMIN_EMAIL="adminEmail" SSO_LOGIN_URL=http://edge_sso_IP_DNS:9099 OAUTH_FLOW=passcode OAUTH_BEARER_TOKEN=token
Em que:
OAUTH_FLOWespecificapasscodeoupassword_grant, dependendo de como você recebeu o token originalmente. Neste exemplo, especifiquepasscodeporque você recebeu o token originalmente usandoget_token. Consulte Como usar o SAML com a API Management do Edge.OAUTH_BEARER_TOKENcontém o token.