Você está visualizando a documentação do Apigee Edge.
Acesse a
documentação da
Apigee X. info
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 nunca 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 oferece suporte a login federado usando credenciais de vários provedores comuns, incluindo:
- GitHub
- OpenID
Além disso, se você já tiver uma conta do Apigee Edge, poderá usar essas credenciais para fazer login no portal do desenvolvedor.
Cada um dos provedores de credenciais com suporte exige um processo de configuração diferente, conforme descrito abaixo.
Como usar credenciais federadas com o portal do desenvolvedor
Para ter acesso ao portal, o desenvolvedor precisa registrar uma nova conta e especificar um nome de usuário, endereço de e-mail e senha. O usuário pode fazer login no portal fornecendo o nome de usuário e a senha do portal como credenciais.
Com o login federado no portal, você usa credenciais de terceiros para fazer login em uma conta de portal existente. Ou seja, você precisa de uma conta no portal antes de fazer login com credenciais de terceiros. É possível usar qualquer uma das credenciais federadas com suporte da Apigee para fazer login em uma conta de portal existente. Além disso, você pode usar as credenciais do Google e da Apigee para registrar uma nova conta no portal.
Fazer login em uma conta do Portal
Faça login em uma conta do portal usando qualquer uma das credenciais federadas compatíveis. Por exemplo, faça login usando suas credenciais do Twitter. Na primeira vez que você fizer login com suas credenciais do Twitter, o portal vai pedir que você as associe a uma conta do portal. Você só precisa fazer essa associação uma vez. Depois disso, você pode fazer login com suas credenciais do Twitter, e o portal retém 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 um novo desenvolvedor no portal usando credenciais federadas, o portal do desenvolvedor tenta coletar informações, geralmente o 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ê vai receber uma solicitação para aprovar as informações transmitidas do Google para o portal. Mesmo que o sistema de registro retorne informações para o portal, novos registros geralmente são necessários para inserir algumas informações, como a aceitação dos termos e condições.
Registrar ou fazer login usando as credenciais do Apigee
Se você já tiver uma conta do Apigee Edge, poderá usar essas credenciais para registrar uma conta ou fazer login em uma conta existente no portal do desenvolvedor. Por padrão, o botão abaixo aparece nas páginas de registro e login do portal do desenvolvedor:
O botão só aparece em portais com um URL que termina em 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 do Apigee Edge como um novo desenvolvedor do portal:
Observação: o processo de registro pressupõe que você tenha configurado o portal 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.
- Verifique se você tem uma conta do Apigee Edge.
- Selecione o link "Registrar" no portal do desenvolvedor.
- 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.
- Se nenhuma outra informação for necessária para o registro, você vai fazer login no portal
de desenvolvedores com sua nova conta.
Você vai receber um e-mail no endereço associado à sua conta do Apigee com informações sobre como concluir o processo de registro, como definir sua senha. - Se houver outras informações necessárias para concluir o processo de registro, como aceitar os Termos e Condições, você será redirecionado automaticamente de volta à 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.
- Especifique todas as outras informações de registro necessárias para concluir o processo.
- Selecione "Criar conta nova".
Você vai receber um e-mail no endereço associado à sua conta do Apigee com informações sobre como concluir o processo de registro, como definir sua senha.
Para fazer login como um desenvolvedor do portal usando uma conta da Apigee:
- Selecione o link "Fazer login" no portal do desenvolvedor.
- Selecione o botão "Autenticar com a Apigee" na página de login.
- Se você já tiver feito login no Apigee Edge, ele 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 ou fazer login usando as credenciais do Google
O registro federado e o login usando credenciais do Google são ativados no portal do desenvolvedor por padrão. Nas páginas de registro e login, você vai encontrar o seguinte botão:
Você pode se registrar como um novo desenvolvedor ou fazer login como um desenvolvedor existente usando suas credenciais do Google. Por exemplo, se você tiver uma conta do Gmail, poderá fazer login usando suas 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ê pode conferir o OpenID selecionando seu endereço de e-mail > Editar perfil no menu de nível superior do portal do desenvolvedor e, em seguida, selecionando "Gerenciar" seus OpenIDs.
Para se registrar como um novo desenvolvedor usando suas credenciais do Google, faça o seguinte:
Observação: o processo de registro pressupõe que você tenha configurado o portal 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.
- Verifique se você tem uma Conta do Google, como uma conta do Gmail.
- Selecione o link "Registrar" no portal do desenvolvedor.
- Selecione o botão "Autenticar com o Google" na página de registro.
Você vai ser direcionado a uma página do Google em que precisa aceitar que o portal do desenvolvedor pode acessar seu endereço de e-mail do Google e informações básicas. - Selecione "Aceitar" para aprovar.
- Você será redirecionado de volta à página de registro do portal para desenvolvedores, com as informações do Google preenchendo os campos de registro.
- Especifique as informações obrigatórias ausentes para concluir o processo de registro.
- Selecione "Criar conta nova".
Você vai receber um e-mail na sua conta do Gmail com informações sobre como concluir o processo de inscrição.
Para fazer login como um desenvolvedor:
- Selecione o link "Fazer login" no portal do desenvolvedor.
- Selecione o botão "Autenticar com o Google" na página de login.
- Se você já tiver feito login no Google, também vai fazer login no portal.
- Se você não tiver feito login no Google, insira suas credenciais para fazer login no portal.
- Se esta for a primeira vez que você fizer login usando as credenciais do Google, você será redirecionado para uma página no portal em que terá que associar sua Conta do Google a uma conta existente no portal para desenvolvedores:
- Copie o URL em "Seu OpenID".
- Selecione o link de login na parte de cima da página e faça login usando suas credenciais atuais do portal do desenvolvedor.
- Selecione seu endereço de e-mail > Editar perfil no menu de nível superior do portal do desenvolvedor.
- Na página do perfil, selecione "Gerenciar seus OpenIDs".
- 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
Você pode fazer login como um desenvolvedor usando suas credenciais do Twitter, mas não pode se registrar como um novo usuário.
Para fazer login federado usando as credenciais do Twitter, 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 para desenvolvedores e o Twitter usa o OAuth para autenticação. Portanto, antes de fazer login no portal de desenvolvedores com as credenciais do Twitter, você precisa criar um app do Twitter. Esse app gera a chave de consumidor e a chave secreta de consumidor usadas pelo portal de desenvolvedores e pelo Twitter para se comunicar.
No processo abaixo, primeiro ative o módulo de login do Twitter no portal para desenvolvedores e, em seguida, crie o app do Twitter. Depois de criar o app, 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:
- Faça login no portal como um usuário com privilégios de administrador.
- Selecione "Módulos" no menu de administração do Drupal. A lista de todos os módulos do Drupal instalados vai aparecer.
- Role a página para baixo e marque a caixa de seleção ao lado do módulo de login do Twitter.
- Salve sua 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. Ative esses módulos. - Depois de ativar o módulo de login do Twitter, selecione "Configuração" > "Serviços da Web" > "Twitter" no menu do Drupal.
A tela de configuração do Twitter aparece. - Selecione a guia Configurações .
- Copie o URL de callback. Esse é um URL no formato:
http://{env}-{org-name}.devportal.apigee.com/twitter/oauth
Você precisa desse URL para criar o app do Twitter.
Crie o app do Twitter:
- Acesse esta página em um navegador: https://dev.twitter.com/apps/new e faça login na sua conta do Twitter.
- Insira as seguintes informações sobre seu portal:
Nome: por exemplo, MyApigeePortal
Descrição: 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. - Concordar com os Termos e Condições.
Você será direcionado a uma página do Twitter com as configurações do OAuth, incluindo a chave e o secret do cliente. Você precisa da chave e do secret para configurar o módulo de login do Twitter do Drupal. - Na guia "Configurações", mude o tipo de acesso do aplicativo para "Ler e gravar".
- Selecione "Atualizar a configuração deste aplicativo do Twitter".
Para configurar o módulo de login do Twitter:
- Faça login no portal como um usuário com privilégios de administrador.
- Selecione "Configuração" > "Serviços da Web" > "Twitter" no menu do Drupal.
A tela de configuração do Twitter aparece. - Selecione a guia Configurações .
- Copie a chave do consumidor da página do Twitter para o campo "Chave do consumidor OAUTH".
- Copie a chave secreta do consumidor da página do Twitter para o campo OAUTH Consumer Secret.
- Selecione "Salvar configuração".
- Selecione a guia "Twitter".
- Ainda conectado ao Twitter com a conta que criou o app, selecione o botão Go to Twitter para adicionar uma conta autenticada.
- Selecione a guia "Fazer login".
- Selecione "Não" em "Registrar novos usuários automaticamente".
- 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 um desenvolvedor usando uma conta do Twitter:
- Selecione o link "Fazer login" no portal do desenvolvedor.
- Selecione o botão "Autenticar com o Twitter" na página de login.
- Você é redirecionado para uma página do Twitter.
- Se você já tiver feito login no Twitter, selecione Autorizar app.
- Se você ainda não fez login no Twitter, insira suas credenciais e selecione Authorize app.
- Se essa for a primeira vez que você fizer login usando as credenciais do Twitter, será redirecionado para uma página no portal em que você precisa associar sua conta do Twitter a uma conta existente no portal do desenvolvedor.
- 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 login no portal será feito diretamente.
Fazer login usando as credenciais do GitHub
Você pode fazer login como um desenvolvedor usando suas credenciais do GitHub, mas não pode se registrar como um novo usuário.
Para fazer login federado usando credenciais do GitHub, 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 para desenvolvedores e o GitHub usa o OAuth para autenticação. Portanto, antes de fazer login no portal de desenvolvedores com credenciais do GitHub, você precisa criar um app do GitHub. Esse app gera a chave e o segredo de consumidor usados pelo portal de desenvolvedores e pelo GitHub para se comunicar.
No processo abaixo, você primeiro cria o app do GitHub. Depois, ativa o módulo de conexão do GitHub e adiciona o ID e a chave secreta do cliente no app do GitHub.
Crie o app GitHub:
- Acesse esta página em um navegador: https://github.com/settings/applications/new e, se necessário, faça login na sua conta do GitHub.
- Insira as seguintes informações sobre seu portal:
Nome do aplicativo: por exemplo, MyApigeePortal
Descrição: por exemplo, My Apigee Portal
Site: por exemplo, http://{env}-{org-name}.devportal.apigee.com/
CallbackURL: o URL da página inicial do portal com a extensão /github/register/create. Por exemplo:
http://{env}-{org-name}.devportal.apigee.com/github/register/create
- Opcionalmente, escolha uma imagem.
- Selecione "Registrar aplicativo". O site do GitHub mostra o ID e a chave secreta do cliente que
você precisa para configurar o módulo de conexão do GitHub no portal do desenvolvedor no formulário:
ID do cliente: dbe86111e411d031d8fb
Chave secreta do cliente: e6bd0f838a288113e8b4e531cb6a9487c27f2d79 - Copie esses valores para usar ao configurar o módulo de conexão do GitHub.
Para ativar o módulo de conexão do GitHub:
- Faça login no portal como um usuário com privilégios de administrador.
- Selecione "Módulos" no menu de administração do Drupal. A lista de todos os módulos do Drupal instalados vai aparecer.
- Role a página para baixo e marque a caixa de seleção ao lado do módulo de conexão do GitHub.
- Salve sua configuração.
Ao ativar o módulo de conexão do GitHub, você pode receber uma notificação informando que outros módulos também precisam ser ativados. Elas serão ativadas automaticamente. - 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 aparece. - Insira o ID e a chave secreta do cliente do seu aplicativo do GitHub.
- Coloque o bloco GitHub Connect onde você quer que ele seja exibido.
- Salve a configuração.
Para fazer login como um desenvolvedor usando uma conta do GitHub:
- Selecione o link "Fazer login" no portal do desenvolvedor.
- Selecione o botão "Fazer login com o GitHub" na página de login.
- Você será redirecionado para uma página do GitHub.
- Se você já tiver feito login no GitHub, selecione Permitir acesso.
- Se você ainda não fez login no GitHub, insira suas credenciais e selecione Autorizar app.
- Se esta for a primeira vez que você fizer login usando credenciais do GitHub, você será redirecionado para uma página no portal em que terá que associar sua conta do GitHub a uma conta existente no portal para desenvolvedores.
- 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 você fizer login com suas credenciais do GitHub, o login no portal será feito diretamente.
Fazer login usando credenciais do OpenID
O OpenID permite criar um único nome de usuário e senha para fazer login em qualquer site compatível com o OpenID. Com o OpenID, sua senha não é compartilhada, mas fica apenas com o provedor do OpenID. Cabe ao provedor OpenID verificar sua identidade em outro site. Para mais informações sobre o OpenID, acesse http://openid.net/.
Se você tiver contas em alguns dos sites mais conhecidos, como o Google ou o Yahoo, já terá um OpenID. Por exemplo, um usuário de e-mail do Yahoo tem um OpenID no formato:
https://me.yahoo.com/a/UniqueID
em que UniqueID é gerado pelo Yahoo. Você pode usar esse OpenID para fazer login no portal para desenvolvedores.
Para oferecer suporte ao OpenID com o portal do desenvolvedor, ative 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 são adicionados automaticamente à página de login do portal para desenvolvedores:
O portal do desenvolvedor associa um OpenID à sua conta do portal armazenando o OpenID no perfil do portal. Depois de associar um OpenID à sua conta do portal, você pode conferir o OpenID selecionando seu endereço de e-mail > Editar perfil no menu de nível superior do portal do desenvolvedor e, em seguida, selecionando "Gerenciar seus OpenIDs".
Para ativar o módulo OpenID:
- Faça login no portal como um usuário com privilégios de administrador.
- Selecione "Módulos" no menu de administração do Drupal. A lista de todos os módulos do Drupal instalados vai aparecer.
- Role a página para baixo e marque a caixa de seleção ao lado do módulo OpenID.
- Salve sua configuração.
Nenhuma outra configuração é necessária no portal do desenvolvedor.
Para fazer login como um desenvolvedor usando um OpenID:
- Faça login no portal do desenvolvedor usando suas credenciais do portal do desenvolvedor.
- Selecione seu endereço de e-mail > Editar perfil no menu de nível superior na barra de menus.
- Na página do perfil, selecione "Gerenciar seus OpenIDs".
- Insira seu OpenID e selecione "Adicionar um OpenID".
Agora você pode fazer login usando seu OpenID. - Saia do portal do desenvolvedor.
- Selecione "Fazer login".
- Na página de login, selecione Fazer login usando o OpenID.
- Insira seu OpenID.
- Selecione "Fazer login".
Como alternativa, você pode fazer login diretamente em uma conta do portal de desenvolvedores usando seu OpenID. Na primeira vez, você vai precisar fazer login usando as credenciais do portal do desenvolvedor. O login pela primeira vez associa automaticamente seu OpenID à conta do portal de desenvolvedores. Agora você pode fazer login diretamente usando seu OpenID.