Perguntas frequentes no portal do desenvolvedor do Drupal 7

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

Esta seção fornece respostas para as perguntas mais frequentes, compiladas com base nas perguntas publicadas na comunidade ou no suporte da Apigee.

Categoria Perguntas frequentes
Configurar um portal para desenvolvedores do Drupal
Gerenciar o ambiente do portal
Personalizar a aparência do portal
Personalizar o registro de usuários e aplicativos
Backup, recuperação e alta disponibilidade
Proteger o portal
Controlar o acesso ao conteúdo
Configurar e-mail e notificações
Resolver problemas
Acessar o código

Configurar um portal para desenvolvedores do Drupal

Como faço para configurar um portal para desenvolvedores do Drupal?

A hospedagem patrocinada pela Apigee para portais baseados em Drupal foi encerrada em 31 de maio de 2020. Para informações sobre como configurar um portal do desenvolvedor existente, consulte Como criar um portal do desenvolvedor.

Quais navegadores e versões de navegadores são compatíveis com o portal?

Consulte Software e versões compatíveis.

Gerenciar o ambiente do portal

Como gerencio meu ambiente de portal na nuvem pública?

A Apigee usa o Pantheon, um serviço de gerenciamento de sites, para hospedar versões baseadas na nuvem do portal de serviços para desenvolvedores. Para mais informações, consulte Como trabalhar com o Pantheon.

A Apigee usa o Acquia, um serviço de gerenciamento de sites, para hospedar versões baseadas na nuvem do portal de serviços para desenvolvedores na União Europeia (UE). Para mais informações, consulte Como trabalhar com o Acquia.

O Pantheon e o Acquia oferecem ferramentas para desenvolver, testar e publicar um portal baseado no Drupal em um ambiente seguro.

Como gerencio meu ambiente de portal na nuvem privada?

Como cliente da nuvem privada do Apigee Edge, você precisará gerenciar o ambiente do portal por conta própria. Veja as recomendações em Práticas recomendadas de ambiente de servidor e desenvolvimento do Drupal.

Como faço para aplicar as atualizações da Apigee ao meu portal do desenvolvedor na nuvem pública?

Para aplicar as atualizações da Apigee ao portal do desenvolvedor na nuvem pública:

  • Pantheon: quando a Apigee publica uma nova versão do portal, uma mensagem é exibida no painel do Pantheon. Verifique se há atualizações regularmente e aplique as atualizações de segurança imediatamente. Para mais informações, consulte Como aplicar uma atualização da Apigee ao portal.

    Observação: na área "Status" de um ambiente, acessada no item de menu "Status" à esquerda do painel, é possível ver que há atualizações disponíveis para os módulos do Drupal. Ignore essas atualizações. A Apigee incorpora automaticamente atualizações dos módulos Drupal na próxima versão do portal para você. Ao permitir que a Apigee atualize os módulos do Drupal para você, a Apigee garante que essas atualizações sejam testadas em relação ao código mais recente do portal. Se você atualizar um módulo Drupal fora do ciclo normal de lançamento do portal da Apigee, poderá encontrar problemas imprevistos.

  • Aquisição: periodicamente, a Apigee atualiza automaticamente os módulos e temas no seu portal para a versão mais recente. As atualizações são feitas apenas no ambiente de desenvolvimento e são marcadas para indicar que precisam ser migradas para outros ambientes do portal. Para mais informações, consulte Como aplicar atualizações de módulo e tema ao portal.

Como faço para aplicar as atualizações da Apigee ao meu portal do desenvolvedor na nuvem privada?

Para clientes do Apigee Edge para nuvem privada, quando a Apigee publicar uma nova versão do portal, será possível fazer upgrade do portal do desenvolvedor para a versão mais recente, conforme descrito em Como fazer upgrade do portal de serviços para desenvolvedores.

Entre as versões de nuvem privada do Apigee Edge, você pode receber uma notificação de que uma nova versão do Drupal está disponível. Uma nova versão pode significar um lançamento de recurso, um patch, uma atualização de segurança ou outro tipo de atualização do Drupal. No caso de uma atualização de segurança, faça upgrade da instalação do Drupal o mais rápido possível para garantir que o site continue seguro. Para mais informações, consulte Como fazer upgrade da versão do Drupal de uma instalação de nuvem privada.

Personalizar a aparência do portal

Como faço para personalizar a aparência do portal?

Com o Drupal, é possível criar um portal altamente personalizado ajustando o tema do Drupal e adicionando módulos personalizados.

Observação: há uma curva de aprendizado para implementar as personalizações mais avançadas do Drupal. É possível contratar um terceiro com experiência no Drupal para conseguir a aparência desejada dentro do prazo desejado.

Abaixo estão alguns recursos para ajudar você a personalizar seu portal usando o Drupal:

Como adiciono módulos e temas personalizados ao meu portal na nuvem pública?

Você pode expandir a funcionalidade do portal adicionando seus próprios módulos e temas personalizados.

Para adicionar módulos e temas personalizados ao seu portal baseado na nuvem, consulte uma das seções a seguir, dependendo de você usar o Patheon ou o Acquia para gerenciar o portal:

Observação: modifique somente o conteúdo no diretório /sites/all. Se você modificar um conteúdo que está fora do diretório /sites/all, poderá ter conflitos de mesclagem ao verificar as mudanças no Git.

Para conferir práticas recomendadas e informações sobre como adicionar e atualizar módulos personalizados, consulte Como adicionar módulos e temas e Atualizar módulos, respectivamente, na documentação do Drupal.

Como adiciono módulos e temas personalizados ao meu portal na nuvem privada?

Você pode expandir a funcionalidade do portal adicionando seus próprios módulos e temas personalizados. Para conferir práticas recomendadas e informações sobre como adicionar e atualizar módulos personalizados, consulte Como adicionar módulos e temas e Atualizar módulos, respectivamente, na documentação do Drupal.

Observação: modifique somente o conteúdo no diretório /sites/all. Se você modificar um conteúdo que está fora do diretório /sites/all, poderá ter conflitos de mesclagem ao verificar as mudanças no Git.

Personalizar o registro de usuários e aplicativos

Como personalizar a página de registro de novos usuários?

Quando o usuário se registra em uma conta, o portal exibe a página de registro padrão com campos para nome, sobrenome, nome de usuário, endereço de e-mail e senha. Como provedor de API, talvez você queira modificar esse formulário para solicitar mais informações ao usuário, como nome da empresa, endereço de correspondência etc. Para mais informações, consulte:

Como personalizar a página de registro do app?

Quando um desenvolvedor de aplicativos registra um aplicativo, o portal exibe um formulário padrão. Como provedor de API, talvez você queira modificar o formulário de registro do app para solicitar que o desenvolvedor forneça mais informações, como um ID de cliente, a plataforma de destino do app ou outras informações. Veja mais informações nos links abaixo:

Como uso o LDAP para autenticação no portal do desenvolvedor?

As seguintes fontes descrevem como usar o LDAP para autenticação:

Comunidade Apigee

Documentação da Drupal

Como faço login no portal usando minhas credenciais do Twitter, do Google ou do GitHub?

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. O portal oferece suporte ao login federado, usando credenciais de vários provedores comuns, incluindo: GitHub, Google, OpenID e Twitter. Para mais informações, consulte Como usar credenciais federadas no portal do desenvolvedor.

Como aplicar um fluxo de trabalho para a aprovação manual da chave de API?

É possível configurar a aprovação manual da chave de API para o registro do app ao criar um produto de API. Nesse caso, será necessário aprovar manualmente uma chave de API quando um desenvolvedor registrar um app.

Para recomendações sobre como aplicar um fluxo de trabalho para aprovação manual da chave de API, consulte o seguinte artigo da comunidade: Qual é a melhor maneira no portal do desenvolvedor para aplicar um fluxo de trabalho para a aprovação manual de chaves de API?.

Backup, recuperação e alta disponibilidade

Como fazer backup e restaurar meu portal na nuvem pública?

As etapas para fazer backup de um portal na nuvem pública são diferentes dependendo se você usa o Pantheon ou o Acquia para gerenciar seu portal:

Como faço para fazer backup e restaurar meu portal na nuvem privada?

Faça backup e restaure o portal na nuvem privada usando os comandos pg_dump e pg_restore do Postgres. Para mais informações, consulte Fazer backup do portal.

Como asseguro a alta disponibilidade do portal do desenvolvedor na minha nuvem pública?

As ferramentas de gerenciamento Pantheon e Acquia Drupal garantem 99,5% de disponibilidade para os portais hospedados. Veja mais informações nos links abaixo:

Como asseguro a alta disponibilidade para o portal do desenvolvedor na minha nuvem privada?

Não existe uma abordagem que sirva para todos os casos para garantir alta disponibilidade no portal do desenvolvedor. Recomendamos que você peça a ajuda de alguém com experiência em:

  • Como configurar sistemas de arquivos e bancos de dados em uma configuração de alta disponibilidade
  • Desenvolvimento do portal Drupal 7

Entre em contato com a equipe de sucesso do cliente da Apigee se precisar de ajuda. Além disso, consulte os seguintes artigos da comunidade:

Proteger o portal

Como configurar a segurança do portal?

O Drupal também tem muitos recursos de segurança que você precisa conhecer para criar o portal. Para saber mais, consulte Como proteger seu portal.

Como configuro o portal para usar TLS/HTTPS?

TLS (Transport Layer Security, cujo antecessor é o SSL) é a tecnologia de segurança padrão para estabelecer um link criptografado entre um servidor da Web e um cliente da Web, como um navegador ou app. Um link criptografado garante que todos os dados transmitidos entre o servidor da Web e o cliente permaneçam particulares. Para saber como configurar o TLS no portal, consulte Como usar o TLS no portal.

Como aplicar os patches de segurança do Drupal?

Para clientes da nuvem pública do Apigee Edge:

  • Pantheon: quando a Apigee publica uma nova versão do portal, uma mensagem é exibida no painel do Pantheon. Verifique se há atualizações regularmente e aplique as atualizações de segurança imediatamente. Para mais informações, consulte Como aplicar uma atualização da Apigee ao portal.
  • Aquisição: periodicamente, a Apigee atualiza automaticamente os módulos e temas no seu portal para a versão mais recente. As atualizações são feitas apenas no ambiente de desenvolvimento e são marcadas para indicar que precisam ser migradas para outros ambientes do portal. Para saber mais, consulte Como aplicar atualizações de módulo e tema ao portal.

Para clientes do Apigee Edge para nuvem privada, você receberá uma notificação informando que uma nova versão do Drupal está disponível. Uma nova versão pode significar um lançamento de recurso, um patch, uma atualização de segurança ou outro tipo de atualização do Drupal. No caso de uma atualização de segurança, faça upgrade da instalação do Drupal o mais rápido possível para garantir que o site continue seguro. Para mais informações, consulte Como fazer upgrade da versão do Drupal de uma instalação de nuvem privada.

Como me inscrevo para receber atualizações de segurança?

Inscreva-se para receber atualizações do Drupal e da Apigee:

Para clientes de nuvem pública, também é possível se registrar no host do site do Drupal:

Como impeço a enumeração do nome de usuário?

Enumeração de nome de usuário se refere a um método usado por invasores para identificar nomes de usuário existentes usando o formulário de esquecimento de senha, que, por padrão, indica se a senha especificada existe ou não. Os invasores podem continuar tentando nomes de usuário até encontrar um usuário válido. Para evitar a enumeração de nome de usuário, instale o módulo de prevenção de enumeração de nome de usuário.

Como faço para ativar a autenticação de dois fatores?

Não ative a autenticação de dois fatores no Apigee Edge se você publicar suas APIs usando um portal do desenvolvedor da Apigee. Caso contrário, o portal do desenvolvedor não poderá se comunicar com o Edge.

Como as credenciais do Edge são armazenadas e criptografadas no portal do Drupal?

As seguintes fontes fornecem detalhes sobre como as credenciais do Edge são armazenadas e criptografadas no portal do Drupal:

Comunidade Apigee:

Controlar o acesso ao conteúdo

Como controlo o acesso ao conteúdo no portal?

As origens a seguir descrevem como controlar o acesso ao conteúdo no portal:

Comunidade Apigee:

Documentação da Drupal:

Como controlo o acesso aos produtos da API por função?

As fontes a seguir descrevem como controlar o acesso aos produtos da API por função:

Configurar e-mail e notificações

Como especificar um servidor de e-mail SMTP para o portal?

O portal do desenvolvedor exige que você configure um servidor SMTP para enviar mensagens de e-mail. Depois de configurar o servidor SMTP, todos os e-mails enviados pelo portal do desenvolvedor usarão o servidor SMTP. Esses e-mails incluem e-mails enviados para novos desenvolvedores, e-mails enviados para desenvolvedores que perderam a senha e e-mails enviados para desenvolvedores com contas bloqueadas. Para mais informações, consulte Como configurar e-mails.

Como envio um e-mail quando um desenvolvedor registra um app (ou outro evento ocorre)?

As regras do Drupal permitem definir ações do portal em resposta a determinados eventos. Um uso comum das regras é gerar e-mails em resposta a um evento. O portal tem suporte integrado para gerar e-mails para eventos predefinidos, como quando um novo desenvolvedor registra uma conta. No entanto, você pode adicionar suas próprias regras para gerar e-mails. Por exemplo, você pode gerar um e-mail quando o desenvolvedor adiciona, remove ou modifica um app. Para mais informações, consulte Como gerar um e-mail quando ocorre um evento.

Como faço para personalizar as mensagens de e-mail enviadas pelo portal?

É possível configurar várias notificações por e-mail que são enviadas em resposta a atividades específicas, como registro, exclusão, bloqueio e desbloqueio de contas de desenvolvedor. Para mais informações, consulte Como configurar e formatar notificações por e-mail.

Como posso evitar SPAM no portal?

Uma maneira de evitar SPAM no portal é adicionar o CAPTCHA à página de login e a outras páginas ativando os módulos CAPTCHA e reCAPTCHA do Drupal. Confira mais informações em:

Resolver problemas

Como faço para acessar os arquivos de registro do portal?

Selecione Relatórios no menu do Drupal para conferir uma lista de registros e outros relatórios. Por exemplo, selecione Relatórios > Mensagens de registro recentes para ver uma tabela de mensagens de registro recentes.

Vídeo:assista um vídeo curto para saber mais sobre relatórios de registros e configurações de depuração.

Acessar o código

Como faço para acessar o código-fonte do portal do desenvolvedor do Drupal 7?

Para sites hospedados no Pantheon ou no Acquia, você pode acessar o código-fonte do portal do desenvolvedor Drupal 7 pelo painel do site de hospedagem, conforme descrito nas seguintes seções:

Acesse o repositório de código-fonte do Drupal 7 diretamente em: https://github.com/apigee/drupal7-drops. Os sites do Pantheon e do Acquia usam esse repositório para upstream no código-fonte.