Você está visualizando a documentação do Apigee Edge.
Acesse a
documentação da
Apigee X. info
Esta seção fornece orientações sobre como planejar e executar a migração dos recursos do portal Drupal 7 para o portal integrado.
Etapa 1: criar um portal integrado
Antes de migrar os recursos do portal do Drupal 7, você precisa criar um portal integrado.
Para criar um portal integrado:
- Verifique se você tem as funções do portal adequadas para gerenciar um portal integrado.
- Crie um portal integrado.
Quando você cria um portal integrado, um conjunto de páginas iniciais é fornecido para uso 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 o portal integrado
Crie o portal integrado, conforme descrito em Etapas para criar seu portal.
No mínimo, você precisará realizar as etapas listadas na tabela a seguir.
| Etapa | Descrição |
|---|---|
| Desenvolver conteúdo do portal | como informações conceituais e de início. Você pode criar páginas e copiar e colar o conteúdo diretamente do seu portal do Drupal 7. |
| Configurar a navegação | Crie a navegação necessária para corresponder à estrutura atual. |
| Personalizar seu tema | No mínimo, personalize os seguintes componentes para atender aos requisitos de branding: |
| 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 híbridos da Apigee. |
| Gerenciar a visibilidade padrão | Gerenciar a visibilidade padrão de recursos específicos. |
| Configurar uma política de segurança de conteúdo | Configure uma política de segurança de conteúdo (CSP) para todas as páginas do portal a fim de proteger contra script em vários locais (XSS) e outros ataques com injeção de código, se desejar.
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) usando SAML | Configure o provedor de identidade SAML (Beta) no portal integrado.
Observações:
|
Depois que os desenvolvedores fizerem login no portal, você poderá gerenciar a conta deles, conforme descrito em Gerenciar contas de desenvolvedor.
Etapa 4: controlar o acesso a recursos usando públicos-alvo
Se você usa papéis no Drupal 7 para controlar o acesso a um conjunto de recursos, como a documentação da API ou a criação de chaves de API para um produto de API, é possível ter a mesma funcionalidade usando públicos-alvo no portal integrado.
Especificamente, é possível 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 individuais e da equipe de desenvolvedores, consulte Gerenciar públicos-alvo. Quando um novo usuário cria uma conta e faz login no seu portal, é necessário atribuir essa pessoa 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 estas dicas:
- Nomeie seus públicos-alvo com base nas funções 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 compartilhar a responsabilidade pelos apps e gerenciar a participação na equipe.
Etapa 5: publicar suas 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.
Embora você possa ter usado uma especificação OpenAPI para gerar automaticamente os SmartDocs no Drupal 7, o conteúdo é armazenado usando um formato interno sem nenhuma associação com a especificação original da OpenAPI. As equipes de API que usam o Apigee Edge geralmente armazenam especificações da OpenAPI na loja de especificações do Apigee Edge.
Em seguida, publique uma API no seu portal. Prepare-se para:
- Especifique a especificação OpenAPI a ser usada como a origem da documentação, do repositório de especificações, do seu diretório local ou de um URL
- Configurar a visibilidade da documentação (público, usuários de autenticação ou públicos-alvo selecionados)
- Configurar um URL de callback, se necessário
- Adicione uma imagem à exibição no catálogo da API, se quiser
Etapa 6: compartilhar a responsabilidade de um app usando equipes de desenvolvedores
Se os desenvolvedores usarem apps da empresa no Drupal 7 para compartilhar a responsabilidade por um app, eles poderão ter a mesma funcionalidade usando equipes de desenvolvedores no portal integrado.
Os desenvolvedores criam equipes de desenvolvedores para compartilhar a responsabilidade pelos apps e gerenciar a participação na equipe, conforme descrito em Compartilhar a responsabilidade de um app usando equipes de desenvolvedores (Beta).
Você pode informar sua comunidade de desenvolvedores sobre as equipes de desenvolvedores e incentivar a migrar os apps para usar as equipes de desenvolvedores para compartilhar a responsabilidade e fazer a transição para o uso das novas chaves de API. Em seguida, você pode remover todos os apps da empresa e artefatos relacionados usando as APIs Edge.
Também é possível migrar os apps da empresa para as equipes de desenvolvedores, conforme descrito no artigo da comunidade Migrar apps da empresa para as equipes de desenvolvedores.
Etapa 7: preparar o lançamento do portal integrado
Antes de lançar o 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 personalizado 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. |