Configurar um projeto do Adobe Developer Console configure-adc-project
Para chamar a API dos Serviços de IA de conteúdo da AEM, você precisa de credenciais emitidas por um projeto do Adobe Developer Console (ADC). Esta página orienta você na criação do projeto, na seleção de um método de autenticação e na geração da credencial incluída em cada solicitação de API.
Vá para o Adobe Developer Console para iniciar sua organização.
Pré-requisitos prerequisites
Antes de começar, verifique o seguinte:
- Você tem acesso ao Adobe Developer Console para sua organização.
- Você foi adicionado como um Desenvolvedor no perfil de produto dos Serviços de IA de Conteúdo da AEM no Adobe Admin Console. Sem essa função, o cartão de API dos Serviços AEM Content AI aparece desabilitado e a opção de autenticação de Servidor para Servidor está oculta.
- Você sabe os números do programa e do ambiente para o perfil de produto que deseja selecionar (por exemplo,
AEM User - publish - Program 12345 - Environment 67890). - Você tem a função de Administrador do Sistema no Admin Console para o programa. Essa função permite gerenciar perfis de produtos e atribuir usuários ao ambiente.
Escolha um método de autenticação choose-auth
Os Serviços de IA de conteúdo da AEM são compatíveis com dois métodos de autenticação. Escolha o que corresponde à sua integração:
Autenticação de servidor para servidor s2s-auth
-
Selecione APIs e serviços e depois APIs.
-
Filtre por Serviços de IA de Conteúdo da AEM e selecione Criar Projeto para iniciar um novo projeto ou Adicionar API se estiver adicionando o serviço a um projeto existente.
note NOTE Se o cartão de API for desativado com uma mensagem "Licença necessária", o ambiente do AEM as a Cloud Service pode não ser modernizado. Consulte Modernização do ambiente do AEM as a Cloud Service. -
Na caixa de diálogo Configurar API, selecione a autenticação de Servidor para Servidor.
note tip TIP Se a opção de servidor para servidor não estiver disponível, o usuário que está configurando a integração não será adicionado como Desenvolvedor ao Perfil do produto. Consulte Habilitar autenticação de Servidor para Servidor. -
Se necessário, renomeie a credencial. Selecione Próximo.
-
Selecione o Usuário do AEM - publicar - Programa XXX - Ambiente XXX e/ou o Usuário do AEM - autor - Programa XXX - Ambiente XXX Perfil do Produto e selecione Salvar.
-
Revise a configuração da API e da autenticação.
Gerar um token de acesso generate-token
-
No projeto ADC, vá para Credenciais e selecione Gerar token de acesso.
-
Incluir o token no cabeçalho
Authorizationde cada solicitação de API:code language-http Authorization: Bearer YOUR_ACCESS_TOKENnote warning WARNING Armazene o token com segurança. Ele expira e deve ser regenerado periodicamente.
Autenticação da chave de API api-key-auth
-
Ao adicionar a API dos Serviços de IA de conteúdo da AEM ao seu projeto, selecione Chave da API na caixa de diálogo Selecionar tipo de autenticação.
-
Confirme a credencial da chave de API.
-
Para restringir quais origens podem usar a chave, configure os domínios permitidos.
-
Sua Chave de API (ID do Cliente) aparece em Credenciais conectadas. Selecione Copiar.
-
Inclua a chave em cada solicitação de API:
code language-http x-api-key: YOUR_API_KEYSeu projeto está pronto. Use a chave em cada solicitação para acessar os Serviços de IA de conteúdo da AEM.
Próximas etapas next-steps
- Controlar Fontes de Conteúdo - Configure uma fonte de conteúdo no Cloud Manager e acione a aquisição.
- Referência da API da IA de conteúdo - Use seu token de acesso ou chave de API para consultar o conteúdo indexado.