Como usar a autenticação básica para acessar a API Edge

Esta é a documentação do Apigee Edge.
Acesse Documentação da Apigee X. informações

Use a autenticação básica para acessar a API Edge para o Edge para a nuvem do Compute Engine. Com a autenticação básica, você passa suas credenciais, que são o endereço de e-mail da sua conta da Apigee e senha) em cada solicitação à API Edge.

A autenticação básica é o menos seguro dos mecanismos de autenticação suportados. Seu as credenciais não são criptografadas ou codificadas com hash. são codificadas apenas em Base64. Em vez de Basic Authentication, a Apigee recomenda que você use OAuth2 ou SAML para acessar a API Edge.

Formato de autenticação básica

Você pode passar suas credenciais como um cabeçalho codificado em Base64 ou como parâmetros em um para o cliente.

Quando você passa suas credenciais no cabeçalho, é necessário codificá-las em Base64. O seguinte é um exemplo de cabeçalho de Autenticação básica HTTP codificada:

Authorization: Basic YWhhbWlsdG9uQGFwaWdlZS5jb206bXlwYXNzdzByZAo

Com um cliente como curl, você transmite suas credenciais com o -u como no exemplo a seguir:

curl https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval -u email_address:password

O curl codifica seu endereço de e-mail e senha e os adiciona ao campo Authorization para você.

Se você omitir sua senha, será solicitado que ela seja inserida.

Use o endereço de e-mail da sua conta da Apigee, e não seu nome de usuário no Edge. chamadas de API.

Acessar a API Edge com curl

Também é possível definir manualmente a solicitação de cabeçalho Authorization ao usar curl. para acessar a API Edge.

Embora curl codifique suas credenciais, conforme mencionado acima, pode haver casos em que você não quer inserir suas credenciais não codificadas no histórico de comandos.

Para definir os cabeçalhos manualmente e acessar a API Edge com curl:

  1. Codifique seu endereço de e-mail e senha em Base64 com uma ferramenta como base64. Para exemplo: 
      read -es PASS
  echo -n ahamilton@apigee.com:$PASS | base64

    A ferramenta base64 retorna uma string codificada:

    YWhhbWlsdG9uQGFwaWdlZS5jb206bXlwYXNzdzByZAo=
  2. Adicione a string codificada ao cabeçalho Authorization na API Edge conforme mostrado no exemplo a seguir: 
        read -es PASS
    BASIC=$(echo -n ahamilton@apigee.com:$PASS | base64
    curl -H "Authorization: Basic $BASIC" \
    https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval
    {
    "createdAt" : 1491854501264,
    "createdBy" : "noreply_iops@apigee.com",
    "displayName" : "ahamilton",
    "environments" : [ "prod", "test" ],
    "lastModifiedAt" : 1491854501264,
    "lastModifiedBy" : "noreply_iops@apigee.com",
    "name" : "ahamilton",
    "properties" : {
    "property" : [ {
    "name" : "features.isSmbOrganization",
    "value" : "false"
    }, {
    "name" : "features.isCpsEnabled",
    "value" : "true"
    } ]
    },
    "type" : "trial"
    }

Essa solicitação obtém detalhes sobre o parâmetro "ahamilton-eval" organização. Para uma lista completa Endpoints da API Edge, consulte Referência da API Apigee Edge.

Você precisa incluir o cabeçalho Authorization em todas as solicitações.

Desativar a autenticação básica

Para desativar a autenticação básica (desde que OAuth2 ou SAML esteja ativado), envie um solicitação ao suporte do Apigee Edge.

Diretrizes de script

Em algumas situações, não é prático coletar a senha quando o script é executado. Para exemplo, pode ser necessário executar uma tarefa do cron que é acionada quando não há administradores presentes. Nessas você precisa disponibilizar a senha para o script sem intervenção.

Siga as seguintes diretrizes:

  1. Centralize as credenciais em um único arquivo usado como fonte para os programas e scripts que você escreve
  2. Proteja o arquivo de origem das credenciais, na medida do possível, usando a segurança do sistema de arquivos e permissões
  3. Criar um cliente de automação com permissões altamente restritas em recursos específicos na em toda a organização.
.