Perguntas frequentes no portal do desenvolvedor do Drupal 7

Você está visualizando a documentação do Apigee Edge.
Acesse a documentação da Apigee X. info

Esta seção fornece respostas às perguntas mais frequentes, compiladas com base nas perguntas postadas na comunidade ou no suporte da Apigee.

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

Configurar um portal de desenvolvedor do Drupal

Como configurar um portal de desenvolvedor do Drupal?

A partir de 31 de maio de 2020, a hospedagem patrocinada pela Apigee para portais baseados em Drupal foi encerrada. Para saber como configurar um portal de desenvolvedor, consulte Como criar um portal de desenvolvedor.

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

Consulte Software e versões compatíveis.

Gerenciar o ambiente do portal

Como faço para gerenciar 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 em nuvem do portal de serviços para desenvolvedores na União Europeia (UE). Para mais informações, consulte Como trabalhar com a Acquia.

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

Como faço para gerenciar meu ambiente de portal na nuvem privada?

Como cliente da Apigee Edge Private Cloud, você precisa gerenciar seu ambiente de portal por conta própria. Para recomendações, consulte Práticas recomendadas de desenvolvimento e ambiente do servidor do Drupal.

Como aplico atualizações da Apigee ao meu portal do desenvolvedor na nuvem pública?

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

  • Pantheon: quando a Apigee publica uma nova versão do portal, uma mensagem aparece 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 seu portal.

    Observação: na área "Status" de um ambiente, acessada pelo item de menu "Status" à esquerda do painel, é possível ver que há atualizações disponíveis para módulos do Drupal. Ignore essas atualizações. A Apigee incorpora automaticamente as atualizações dos módulos do 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 foram testadas com o código mais recente do portal. Se você atualizar um módulo do Drupal fora do ciclo de lançamento normal do portal da Apigee, poderá encontrar problemas imprevistos.

  • Acquia: a Apigee atualiza automaticamente os módulos e temas do 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 aplico atualizações da Apigee ao meu portal do desenvolvedor na nuvem privada?

Para clientes do Apigee Edge for Private Cloud, quando a Apigee publicar uma nova versão do portal, você poderá fazer upgrade do portal do desenvolvedor para a versão mais recente, conforme descrito em Fazer upgrade do portal de serviços para desenvolvedores.

Entre as versões do Apigee Edge para Private Cloud, 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, patch, atualização de segurança ou outro tipo de atualização do Drupal. No caso de uma atualização de segurança, faça o upgrade da instalação do Drupal o mais rápido possível para garantir que o site continue seguro. Para mais informações, consulte Atualizar a versão do Drupal de uma instalação de nuvem privada.

Personalizar a aparência do portal

Como personalizar a aparência do portal?

Com o Drupal, você pode 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. Você pode contratar uma empresa terceirizada com experiência em Drupal para alcançar a aparência desejada no prazo desejado.

Confira abaixo alguns recursos que vão ajudar você a personalizar seu portal usando o Drupal:

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

É possível expandir a funcionalidade do portal adicionando seus próprios temas e módulos personalizados.

Para adicionar módulos e temas personalizados ao seu portal baseado em nuvem, consulte uma das seguintes seções com base no uso do Patheon ou da Acquia para gerenciar seu portal:

Observação: modifique apenas o conteúdo no diretório /sites/all. Se você modificar conteúdo fora do diretório /sites/all, poderá ocorrer conflitos de mesclagem ao fazer check-in de mudanças no Git.

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

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

É possível expandir a funcionalidade do portal adicionando seus próprios temas e módulos personalizados. Para práticas recomendadas e informações sobre como adicionar e atualizar módulos personalizados, consulte Adicionar módulos e temas e Atualizar módulos, respectivamente, na documentação do Drupal.

Observação: modifique apenas o conteúdo no diretório /sites/all. Se você modificar conteúdo fora do diretório /sites/all, poderá ocorrer conflitos de mesclagem ao fazer check-in de mudanças no Git.

Personalizar o registro de usuários e apps

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

Quando o usuário se registra para uma conta no portal, a página de registro padrão é exibida com campos para nome, sobrenome, nome de usuário, endereço de e-mail e senha. Como provedor de API, você pode modificar esse formulário para solicitar ao usuário informações adicionais, como nome da empresa, endereço postal ou outras informações. Para mais informações, consulte:

Como personalizar a página de registro do app?

Quando um desenvolvedor de apps registra um app, o portal mostra um formulário padrão. Como provedor de API, você pode 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. Confira mais informações em:

Como usar o LDAP para autenticação no portal para desenvolvedores?

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

Comunidade da Apigee

Documentação do Drupal

Como faço para fazer login no portal usando minhas credenciais do Twitter, Google ou 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 Usar credenciais federadas no portal do desenvolvedor.

Como aplicar um fluxo de trabalho para aprovação manual de chaves de API?

É possível configurar a aprovação manual de chaves de API para o registro de apps ao criar um produto de API. Nesse caso, você precisa aprovar manualmente uma chave de API quando um desenvolvedor de apps registra um app.

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

Backup, recuperação e alta disponibilidade

Como faço backup e restauro 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 backup e restauro meu portal na nuvem privada?

Você faz backup e restaura 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 garantir alta disponibilidade para o portal do desenvolvedor na minha nuvem pública?

As ferramentas de gerenciamento do Drupal do Pantheon e da Acquia garantem 99,5% de disponibilidade para os portais que hospedam. Confira mais informações em:

Como garantir a alta disponibilidade do portal para desenvolvedores na minha nuvem privada?

Não existe uma abordagem única para garantir a alta disponibilidade do portal do desenvolvedor. É altamente recomendável pedir a ajuda de alguém com experiência em:

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

Entre em contato com a equipe de sucesso do cliente da Apigee se precisar de ajuda. Confira também estes 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 ao criar seu portal. Consulte Como proteger seu portal para saber mais.

Como configurar o portal para usar TLS/HTTPS?

O 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 privados. Para informações sobre como configurar o TLS com o portal, consulte Como usar o TLS no portal.

Como aplico 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 aparece 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 seu portal.
  • Acquia: a Apigee atualiza automaticamente os módulos e temas do 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.

Para clientes do Apigee Edge para nuvem privada, você vai 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, patch, 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 assim que possível para garantir que o site continue seguro. Para mais informações, consulte Atualizar a versão do Drupal de uma instalação de nuvem privada.

Como faço para me inscrever nas 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 com o host do site do Drupal:

Como impedir a enumeração de nomes de usuário?

A enumeração de nomes de usuário se refere a um método que os invasores usam para identificar nomes de usuário que existem usando o formulário "Esqueci minha 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 nomes de usuário, instale o módulo de prevenção de enumeração de nomes 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 fontes a seguir fornecem detalhes sobre como as credenciais do Edge são armazenadas e criptografadas no portal do Drupal:

Comunidade da Apigee:

Controlar o acesso ao conteúdo

Como controlar o acesso ao conteúdo do portal?

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

Comunidade da Apigee:

Documentação do Drupal:

Como controlar o acesso a produtos de API por função?

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

Configurar e-mails 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 usam 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 o e-mail.

Como enviar 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, é possível gerar um e-mail quando o desenvolvedor adiciona, remove ou modifica um app. Para mais informações, consulte Como gerar um e-mail quando um evento ocorre.

Como 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 o SPAM no portal?

Uma maneira de evitar o 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 ver uma lista de registros e outros relatórios. Por exemplo, selecione Reports > Recent log messages para ver uma tabela de mensagens de registro recentes.

Vídeo:assista um vídeo curto para saber mais sobre relatórios de registro 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, é possível acessar o código-fonte do portal do desenvolvedor do Drupal 7 pelo painel do site de hospedagem, conforme descrito nas seções a seguir:

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