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:
- Verifique se você tem os papéis de portal apropriados para gerenciar um portal integrado.
- 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. |