Como usar credenciais federadas no portal do desenvolvedor

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. informações

O login federado é o processo em que você usa credenciais de um sistema de gerenciamento de identidade, chamado de sistema de registro, para fazer login em outro sistema. Por exemplo, você usa suas credenciais do Google ou do Twitter para fazer login no portal do desenvolvedor da Apigee. A vantagem do login federado é que o sistema em que você está fazendo login não vê a senha associada às suas credenciais. Isso significa que suas senhas não precisam ser copiadas para sistemas diferentes.

O portal de serviços para desenvolvedores é compatível com login federado usando credenciais de vários provedores comuns, incluindo:

  • GitHub
  • Serviços
  • OpenID
  • Twitter

Além disso, se você já tem uma conta do Apigee Edge, pode usar essas credenciais para fazer login no portal do desenvolvedor.

Cada um dos provedores de credenciais compatíveis exige um processo de configuração diferente, conforme descrito abaixo.

Como usar credenciais federadas com o portal do desenvolvedor

Para ter acesso ao portal, um desenvolvedor registra uma nova conta e especifica um nome de usuário, endereço de e-mail e senha. Em seguida, o usuário pode fazer login no portal fornecendo o nome de usuário e a senha dele como credenciais.

Com o login federado no portal, você usa credenciais de terceiros para fazer login em uma conta do portal. Ou seja, é necessário ter uma conta no portal para fazer login com credenciais de terceiros. É possível usar qualquer uma das credenciais federadas aceitas pela Apigee para fazer login em uma conta do portal. Além disso, é possível usar as credenciais do Google e da Apigee para registrar uma nova conta no portal.

Como fazer login em uma conta do portal

Faça login em uma conta do portal usando qualquer uma das credenciais federadas aceitas. Por exemplo, faça login usando suas credenciais do Twitter. Na primeira vez que você fizer login com suas credenciais do Twitter, o portal solicitará que você as associe a uma conta do portal. Essa associação é feita apenas uma vez. Depois disso, faça login com suas credenciais do Twitter e o portal manterá as informações de associação.

Como registrar uma nova conta do portal

Registre uma nova conta no portal usando suas credenciais do Google ou da Apigee. Quando você se registra como novo desenvolvedor no portal usando credenciais federadas, o portal do desenvolvedor tenta conseguir informações, geralmente endereço de e-mail, do sistema de registro. Por exemplo, você usa suas credenciais do Google para criar uma nova conta de desenvolvedor no portal. Você precisa aprovar as informações enviadas de volta para o portal do Google. Mesmo que o sistema de registro retorne informações para o portal, os novos registros normalmente são necessários para inserir algumas informações, como aceitar os Termos e Condições.

Registre-se ou faça login usando as credenciais da Apigee

Se você já tem uma conta do Apigee Edge, é possível usar essas credenciais para registrar uma conta ou fazer login em uma conta atual no portal do desenvolvedor. Por padrão, o seguinte botão aparece nas páginas de registro e login do portal do desenvolvedor:

O botão só aparece nos portais com um URL que termina com apigee.com, ou seja, portais no domínio da Apigee. Por exemplo, um URL no formato http://myCompany.devportal.apigee.com. Se o URL não terminar com esse domínio, não será possível usar suas credenciais do Apigee Edge para fazer login ou se registrar no portal.

Para registrar um usuário atual do Apigee Edge como um novo desenvolvedor do portal:

Observação: o processo de registro pressupõe que seu portal está configurado para permitir que qualquer pessoa se registre sem a aprovação do administrador. Consulte Adicionar e gerenciar contas de usuário para mais informações sobre como controlar quem pode se registrar.

  1. Verifique se você tem uma conta do Apigee Edge.
  2. Selecione o link "Registrar" no portal do desenvolvedor.
  3. Selecione o botão "Autenticar com a Apigee" na página de registro.
    • Se você não tiver feito login no Apigee Edge, insira suas credenciais e selecione "Fazer login".
  4. Se nenhuma outra informação for necessária para o registro, você será conectado ao portal do desenvolvedor com sua nova conta.
    Você receberá um e-mail no endereço associado à sua conta da Apigee com informações sobre como concluir o processo de registro, como definir sua senha.
  5. Se houver outras informações necessárias para concluir o processo de registro, como aceitar os Termos e Condições, você será redirecionado automaticamente para a página de registro com o nome de usuário e as informações de e-mail da sua conta do Apigee Edge inseridos nos campos apropriados.
  6. Especifique outras informações de registro necessárias para concluir o processo.
  7. Selecione Criar nova conta.
    Você receberá um e-mail no endereço associado à sua conta da Apigee com informações sobre como concluir o processo de registro, como definir sua senha.

Para fazer login como desenvolvedor do portal usando uma conta da Apigee:

  1. Selecione o link de login no portal do desenvolvedor.
  2. Selecione o botão "Autenticar com a Apigee" na página de login.
    • Se você já tiver feito login no Apigee Edge, o login será feito automaticamente no portal do desenvolvedor.
    • Se você não tiver feito login no Apigee Edge, insira suas credenciais e selecione "Fazer login".

Registrar-se ou fazer login usando as credenciais do Google

O registro federado e o login usando as credenciais do Google são ativados por padrão no portal do desenvolvedor. Nas páginas de registro e de login, você verá o seguinte botão:

É possível se registrar como um novo desenvolvedor ou fazer login como desenvolvedor atual usando suas credenciais do Google. Por exemplo, se você tem uma conta do Gmail, é possível fazer login usando as credenciais do Gmail.

O portal do desenvolvedor associa as credenciais do Google à sua conta do portal armazenando um OpenID do Google no seu perfil. Depois de associar as credenciais do Google à sua conta do portal, você poderá ver o OpenID selecionando seu endereço de e-mail > Editar perfil no menu de nível superior no portal do desenvolvedor e, em seguida, selecionando Gerenciar seus OpenIDs.

Para se registrar como um novo desenvolvedor usando as credenciais do Google:

Observação: o processo de registro pressupõe que seu portal está configurado para permitir que qualquer pessoa se registre sem a aprovação do administrador. Consulte Adicionar e gerenciar contas de usuário para mais informações sobre como controlar quem pode se registrar.

  1. Verifique se você tem uma Conta do Google, como uma conta do Gmail.
  2. Selecione o link "Registrar" no portal do desenvolvedor
  3. Selecione o botão "Autenticar com o Google" na página de registro.
    Vamos direcionar você para uma página do Google pedindo que você aceite que o portal do desenvolvedor possa acessar seu endereço de e-mail do Google e informações básicas.
  4. Selecione "Aceitar" para aprovar.
  5. Você será redirecionado para a página de registro do portal do desenvolvedor, com as informações do Google preenchendo automaticamente os campos de registro.
  6. Especifique as informações necessárias ausentes para concluir o processo de registro.
  7. Selecione Criar nova conta.
    Você vai receber um e-mail na sua conta do Gmail com informações para concluir o processo de registro.

Para fazer login como desenvolvedor atual:

  1. Selecione o link de login no portal do desenvolvedor.
  2. Selecione o botão "Autenticar com o Google" na página de login.
    • Se você já tiver feito login no Google, também no portal.
    • Se você não tiver feito login no Google, insira suas credenciais do Google para fazer login no portal.
  3. Se esta é a primeira vez que você faz login usando as credenciais do Google, vamos redirecionar você para uma página no portal em que é necessário associar sua Conta do Google a uma conta atual no portal do desenvolvedor:

  4. Copie o URL em Your OpenID.
  5. Selecione o link de login na parte superior da página e use suas credenciais do portal do desenvolvedor para fazer login.
  6. Selecione seu endereço de e-mail > Editar perfil no menu de nível superior no portal do desenvolvedor.
  7. Na página do seu perfil, selecione Gerenciar seus OpenIDs.
  8. Digite o URL do OpenID e selecione Adicionar OpenID.
    Agora você pode fazer login usando suas credenciais do Google.

Fazer login usando as credenciais do Twitter

É possível fazer login como desenvolvedor usando suas credenciais do Twitter, mas não é possível se registrar como novo usuário.

O login federado usando credenciais do Twitter exige que você ative o módulo Drupal Twitter Signin no portal do desenvolvedor. Depois de ativar esse módulo, o botão a seguir vai aparecer na página de login:

A conexão entre o portal do desenvolvedor e o Twitter usa o OAuth para autenticação. Portanto, antes de fazer login no portal do desenvolvedor com as credenciais do Twitter, crie um app para o Twitter. Em seguida, esse app gera a chave e o segredo do consumidor usados pelo portal e pelo Twitter para se comunicar.

No processo abaixo, você precisa ativar o módulo de login do Twitter no portal do desenvolvedor e depois criar o app do Twitter. Depois disso, volte ao módulo de login do Twitter e adicione as informações de configuração necessárias do app do Twitter.

Para ativar o módulo de Login do Twitter:

  1. Faça login no portal como usuário com privilégios de administrador.
  2. Selecione Módulos no menu de administração do Drupal. A lista de todos os módulos Drupal instalados é exibida.
  3. Role a página para baixo e marque a caixa de seleção ao lado do módulo de Login do Twitter.
  4. Salve a configuração.
    Ao ativar o módulo de Login do Twitter, você pode receber uma notificação de que outros módulos também precisam ser ativados. Certifique-se de ativar esses módulos.
  5. Depois que o módulo de Login do Twitter for ativado, selecione Configuração > Serviços da Web > Twitter no menu do Drupal.
    A tela de configuração do Twitter será exibida.
  6. Selecione a guia "Configurações".
  7. Copie o URL de callback. Use um URL no seguinte formato:

    http://{env}-{org-name}.devportal.apigee.com/twitter/oauth

    Você precisa desse URL para criar o app Twitter.

Crie o app Twitter:

  1. Acesse esta página em um navegador: https://dev.twitter.com/apps/new e faça login na sua conta do Twitter.
  2. Digite as seguintes informações sobre o portal:
    Name: por exemplo MyApigeePortal
    Description: por exemplo, My Apigee Portal
    Site: por exemplo, http://{env}-{org-name}.devportal.apigee.com/
    CallbackURL: copie o URL de callback da tela de configuração do módulo de login do Twitter.
  3. Concorde com os termos/condições.
    Vamos direcionar você para uma página do Twitter com as configurações do OAuth, incluindo a chave e a chave secreta do cliente. Você precisa da chave e do secret para configurar o módulo de login do Twitter do Drupal.
  4. Na guia Configurações, altere o Acesso do tipo de aplicativo para Leitura e gravação.
  5. Selecione Atualizar a configuração deste aplicativo do Twitter.

Para configurar o módulo de login do Twitter:

  1. Faça login no portal como usuário com privilégios de administrador.
  2. Selecione Configuration > Web Services > Twitter no menu Drupal.
    A tela de configuração do Twitter será exibida.
  3. Selecione a guia "Configurações".
  4. Copie a chave do cliente da página do Twitter para o campo "Chave do cliente OAUTH".
  5. Copie o secret do cliente da página do Twitter para o campo "OAUTH Consumer Secret".
  6. Selecione "Salvar configuração".
  7. Selecione a guia do Twitter.
  8. Faça login no Twitter com a conta que criou o app do Twitter e clique no botão "Ir para o Twitter" para adicionar uma conta autenticada.
  9. Selecione a guia Login.
  10. Selecione Não em Registrar novos usuários automaticamente.
  11. Salve a configuração.
    Agora os usuários do Twitter podem se registrar no portal do desenvolvedor e fazer login usando as credenciais do Twitter.

Para fazer login como desenvolvedor usando uma conta do Twitter:

  1. Selecione o link de login no portal do desenvolvedor.
  2. Selecione o botão Autenticar com o Twitter na página de login.
  3. Você será redirecionado a uma página do Twitter.
    • Se você já tiver feito login no Twitter, selecione "Autorizar aplicativo".
    • Se você ainda não tiver feito login no Twitter, insira suas credenciais do Twitter e selecione "Autorizar app".
  4. Se esta é a primeira vez que você faz login usando credenciais do Twitter, o sistema redirecionará você para uma página no portal em que é necessário associar sua conta do Twitter a uma conta atual no portal do desenvolvedor.
  5. Insira o nome de usuário e a senha da conta que você quer associar à sua conta do Twitter. Você só precisa fazer isso uma vez.
    Na próxima vez que você fizer login com suas credenciais do Twitter, o acesso ao portal será feito diretamente.

Fazer login usando as credenciais do GitHub

É possível fazer login como desenvolvedor usando suas credenciais do GitHub, mas não é possível se registrar como um novo usuário.

O login federado usando credenciais do GitHub requer que você ative o módulo Drupal GitHub Connect no portal do desenvolvedor. Depois de ativar esse módulo, o botão a seguir vai aparecer na página de login:

A conexão entre o portal do desenvolvedor e o GitHub usa o OAuth para autenticação. Portanto, antes de fazer login no portal do desenvolvedor com as credenciais do GitHub, crie um app do GitHub. Em seguida, esse app gera a chave e o segredo do consumidor usados pelo portal e pelo GitHub para se comunicar.

No processo abaixo, você primeiro cria o app GitHub. Depois disso, ative o módulo de conexão do GitHub e adicione o ID e a chave secreta do cliente no app GitHub.

Crie o app GitHub:

  1. Navegue até esta página em um navegador: https://github.com/settings/applications/new e, se necessário, faça login na sua conta do GitHub.
  2. Digite as seguintes informações sobre seu portal:
    Application Name: for example MyApigeePortal
    Description: for example My Apigee Portal
    Website: por exemplo, http://{env}-{org-name}.devportal.apigee.com/
    CallbackURL: o URL da página inicial do seu portal com a extensão /github/register/create. Por exemplo:

    http://{env}-{org-name}.devportal.apigee.com/github/register/create
  3. Se quiser, escolha uma imagem.
  4. Selecione "Registrar aplicativo". O site do GitHub exibe o ID e a chave secreta do cliente necessários para configurar o módulo de conexão do GitHub no portal do desenvolvedor no formato:
    ID do cliente: dbe86111e411d031d8fb
    Chave secreta do cliente: e6bd0f838a288113e8b4e531cb6a9487c27f2d
  5. Copie esses valores para usar na configuração do módulo de conexão do GitHub.

Para ativar o módulo de conexão do GitHub:

  1. Faça login no portal como usuário com privilégios de administrador.
  2. Selecione Módulos no menu de administração do Drupal. A lista de todos os módulos Drupal instalados é exibida.
  3. Role a página para baixo e marque a caixa de seleção ao lado do módulo de conexão do GitHub.
  4. Salve a configuração.
    Ao ativar o módulo de conexão do GitHub, você pode receber uma notificação de que outros módulos também precisam estar ativados. Eles devem ser ativados automaticamente.
  5. Depois que o módulo de conexão do GitHub for ativado, selecione "Configuração" > "Pessoas" > "GitHub" no menu do Drupal.
    A tela de configuração do GitHub será exibida.
  6. Insira o ID e a chave secreta do cliente no seu aplicativo GitHub.
  7. Posicione o bloco do GitHub Connect onde você quer que ele seja exibido.
  8. Salve a configuração.

Para fazer login como desenvolvedor usando uma conta do GitHub:

  1. Selecione o link de login no portal do desenvolvedor.
  2. Selecione o botão "Fazer login com o GitHub" na página de login.
  3. Você será redirecionado para uma página do GitHub.
    • Se você já tiver feito login no GitHub, selecione "Allow access".
    • Se você ainda não tiver feito login no GitHub, insira suas credenciais do GitHub e selecione "Autorizar app".
  4. Se esta for a primeira vez que você faz login usando credenciais do GitHub, será redirecionado para uma página no portal em que é necessário associar sua conta do GitHub a uma conta atual no portal do desenvolvedor.
  5. Insira o nome de usuário e a senha da conta que você quer associar à sua conta do GitHub. Você só precisa fazer isso uma vez.
    Na próxima vez que fizer login com suas credenciais do GitHub, você vai acessar o portal diretamente.

Fazer login usando credenciais OpenID

Com o OpenID, é possível criar um nome de usuário e uma senha que podem ser usados para fazer login em qualquer site compatível com o OpenID. Com o OpenID, sua senha não é compartilhada, fica apenas com o provedor OpenID. Cabe ao provedor OpenID confirmar sua identidade para outro site. Para mais informações sobre o OpenID, consulte http://openid.net/.

Se você tem contas em alguns dos sites mais conhecidos, como Google ou Yahoo, já tem um OpenID. Por exemplo, um usuário de e-mail do Yahoo tem um OpenID no formulário:

https://me.yahoo.com/a/UniqueID

em que o UniqueID é gerado pelo Yahoo. É possível usar esse OpenID para fazer login no portal do desenvolvedor.

Para oferecer compatibilidade com o OpenID no portal do desenvolvedor, você precisa ativar o módulo Drupal OpenID. Nenhuma outra configuração é necessária no portal do desenvolvedor. Depois de ativar o módulo OpenID, os links a seguir serão adicionados automaticamente à página de login do portal do desenvolvedor:

O portal do desenvolvedor associa um OpenID à sua conta do portal armazenando o OpenID no seu perfil. Após associar um OpenID à sua conta do portal, será possível acessar o OpenID selecionando seu endereço de e-mail > Editar perfil no menu de nível superior no portal do desenvolvedor e, em seguida, selecionando Gerenciar seus OpenIDs.

Para ativar o módulo OpenID:

  1. Faça login no portal como usuário com privilégios de administrador.
  2. Selecione Módulos no menu de administração do Drupal. A lista de todos os módulos Drupal instalados é exibida.
  3. Role a página para baixo e marque a caixa de seleção ao lado do módulo OpenID.
  4. Salve a configuração.
    Nenhuma outra configuração é necessária no portal do desenvolvedor.

Para fazer login como desenvolvedor usando um OpenID:

  1. Faça login no portal do desenvolvedor usando suas credenciais do portal do desenvolvedor.
  2. Selecione seu endereço de e-mail > Editar perfil no menu de nível superior na barra de menus.
  3. Na página do seu perfil, selecione Gerenciar seus OpenIDs.
  4. Digite o seu OpenID e selecione Adicionar um OpenID.
    Agora é possível fazer login usando o OpenID.
  5. Saia do portal do desenvolvedor.
  6. Selecione Login.
  7. Na página de login, selecione Fazer login usando OpenID.
  8. Insira seu OpenID.
  9. Selecione "Fazer login".

Como alternativa, é possível fazer login diretamente em uma conta do portal do desenvolvedor usando seu OpenID. Na primeira vez que fizer isso, você precisará fazer login usando suas credenciais do portal do desenvolvedor. O primeiro login associa automaticamente seu OpenID à conta do portal do desenvolvedor. Agora você pode fazer login diretamente usando o OpenID.