Como migrar o portal do Drupal 7 para o portal integrado

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

Esta seção fornece orientações sobre como planejar e executar a migração dos recursos do portal do Drupal 7 para o portal integrado.

Etapa 1: criar um portal integrado

Antes de migrar os recursos do portal do Drupal 7, crie um portal integrado.

Para criar um portal integrado:

  1. Verifique se você tem os papéis de portal apropriados para gerenciar um portal integrado.
  2. Crie um portal integrado.

Ao criar um portal integrado, um conjunto de páginas iniciais é fornecido para você usar como ponto de partida. As páginas iniciais têm conteúdo de demonstração para inspirar o desenvolvimento do seu portal à medida que você substitui o texto e as imagens pelo seu conteúdo exclusivo. Para mais informações, consulte Sobre o portal de amostra.

Etapa 2: criar seu portal integrado

Crie seu portal integrado, conforme descrito em Etapas para criar seu portal.

Será necessário, no mínimo, executar as etapas listadas na tabela a seguir.

Step Descrição
Desenvolver conteúdo do portal como informações conceituais e sobre como começar.

É possível criar páginas e, em seguida, copiar e colar o conteúdo delas diretamente do seu portal do Drupal 7.

Configurar a navegação Crie a navegação necessária para corresponder à sua estrutura atual.
Personalizar seu tema Personalize pelo menos os seguintes componentes de acordo com os requisitos da sua marca:
Adicionar scripts personalizados Adicione um código JavaScript personalizado ao seu portal, conforme necessário.
Configurar e-mail Configure o servidor SMTP e o conteúdo das notificações por e-mail.

Observação: no momento, a configuração de notificação por e-mail não está disponível para portais integrados da Apigee híbrida.

Gerenciar a visibilidade padrão Gerenciar a visibilidade padrão de recursos específicos.
Configurar uma Política de Segurança de Conteúdo Se quiser, configure uma política de segurança de conteúdo (CSP) em todas as páginas do seu portal para se proteger contra scripting em vários sites (XSS) e outros ataques de injeção de código.

Observação: no momento, esse recurso não está disponível para portais integrados da Apigee híbrida.

Etapa 3: configurar o provedor de identidade

Configure o provedor de identidade no portal integrado com base no tipo de autenticação, conforme descrito na tabela a seguir.

Autenticação Descrição
Provedor de identidade integrado (nome de usuário/senha) Configure o provedor de identidade integrado no portal integrado.
Logon único (SSO) com SAML Configure o provedor de identidade SAML (Beta) no portal integrado.

Observações:

Depois que os desenvolvedores fizerem login no portal, será possível gerenciar as contas deles conforme descrito em Gerenciar contas de desenvolvedor.

Etapa 4: controlar o acesso a recursos usando públicos-alvo

Se você usar papéis no Drupal 7 para controlar o acesso a um conjunto de recursos, como documentação da API ou criação de chave para um produto de API, é possível alcançar essa mesma funcionalidade usando audiences no portal integrado.

Especificamente, você pode controlar o acesso ao seguinte recurso no portal integrado usando públicos-alvo:

  • Páginas no seu portal
  • Produtos de API publicados

Para adicionar um público-alvo e gerenciar as atribuições de usuários e da equipe de desenvolvedores, consulte Gerenciar públicos-alvo. Quando um novo usuário criar uma conta e fizer login no seu portal, você precisará atribuí-lo a um ou mais públicos-alvo, conforme necessário, conforme descrito em Gerenciar as atribuições de um público-alvo.

Para simplificar a migração, considere as seguintes dicas:

  • Nomeie seus públicos-alvo de acordo com os papéis do Drupal que eles estão substituindo.
  • Gerencie a associação do público-alvo usando as equipes de desenvolvedores. Os desenvolvedores criam equipes para dividir a responsabilidade pelos apps e gerenciar a associação.

Etapa 5: publicar as APIs

Para publicar APIs e gerar automaticamente a documentação de referência da API usando o SmartDocs no portal integrado, você precisa ter acesso à especificação OpenAPI associada à API.

Mesmo que você tenha usado uma especificação OpenAPI para gerar automaticamente os SmartDocs no Drupal 7, o conteúdo é armazenado usando um formato interno sem associação à especificação OpenAPI original. As equipes de API que usam o Apigee Edge normalmente armazenam as especificações OpenAPI no armazenamento de especificações do Apigee Edge.

Em seguida, publique uma API no seu portal. Prepare-se para:

  • Especificar a especificação OpenAPI para usar como origem da documentação no repositório de especificações, no seu diretório local ou em um URL
  • Configurar a visibilidade da documentação (pública, usuários de autenticação ou públicos-alvo selecionados)
  • Configurar um URL de callback, se necessário
  • Se quiser, adicione uma imagem à exibição no seu catálogo de APIs

Etapa 6: compartilhar a responsabilidade por um app usando as equipes de desenvolvedores

Se os desenvolvedores usam apps da empresa no Drupal 7 para compartilhar a responsabilidade por um app, eles podem alcançar essa mesma funcionalidade usando as equipes de desenvolvedores no portal integrado.

Seus desenvolvedores criam equipes para dividir a responsabilidade pelos apps e gerenciar a participação delas, conforme descrito em Compartilhar a responsabilidade por um app usando equipes de desenvolvedores (Beta).

Você pode informar sua comunidade de desenvolvedores sobre as equipes de desenvolvedores e incentivá-los a migrar os apps para usar essas equipes, compartilhando a responsabilidade e fazendo a transição para o uso das novas chaves de API. Depois, é possível remover todos os apps da empresa e artefatos relacionados usando as APIs do Edge.

Como alternativa, você pode migrar os apps da empresa para os da equipe de desenvolvimento, conforme descrito no seguinte artigo da comunidade: Migrar apps da empresa para equipes de desenvolvedores.

Etapa 7: preparar-se para lançar seu portal integrado

Antes de lançar seu portal integrado para produção, siga as etapas definidas na tabela a seguir.

Etapa Descrição
Personalizar seu domínio Forneça seu próprio nome de domínio para personalizar seu site.

Observação: no momento, esse recurso não está disponível para portais integrados da Apigee híbrida.

Configurar o acompanhamento de análises Configure o acompanhamento de análises usando o Google Analytics ou seu próprio serviço personalizado de acompanhamento de análises.
Criar uma página de pesquisa personalizada Crie uma página de pesquisa personalizada e incorpore um mecanismo de pesquisa personalizada do Google.