DocumentaçãoExperience PlatformColeção de dados

[Alpha]{class="badge informative"}

edgeCredentials (SDK do Servidor)

Última atualização: 6 de novembro de 2026

Criado para:

  • Experiente
  • Desenvolvedor

O objeto edgeCredentials contém a credencial OAuth de servidor para servidor que o SDK do servidor usa para autenticar com o Adobe. O SDK troca a credencial por um token de acesso e, em seguida, usa o token para enviar eventos à API autenticada do Edge Network Server. Esta propriedade é obrigatória. O Web SDK não usa essa propriedade porque um navegador não pode manter um segredo do cliente privado.

Consulte Autenticação para saber como criar uma credencial no Adobe Developer Console e como o SDK a utiliza.

Propriedades properties

Propriedade
Tipo
Obrigatório
Descrição
clientId
String
Sim
A ID do cliente da sua credencial OAuth de servidor para servidor. O SDK também o envia no cabeçalho x-api-key de solicitações autenticadas.
clientSecret
String
Sim
O Segredo do Cliente da sua credencial.
scopes
Matriz de cadeias de caracteres
Sim
Os Escopos listados para sua credencial na Adobe Developer Console. Inclua pelo menos um escopo.
imsHost
String
Não
O host do Adobe Identity Management Service (IMS) que emite tokens de acesso. O padrão é ims-na1.adobelogin.com. Altere-o somente se a Adobe instruir o.

Exemplo de código

Defina o objeto edgeCredentials ao chamar configure. Leia os valores das variáveis de ambiente ou de um gerenciador de segredos em vez de colocá-los no código-fonte.

await alloy.configure({
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  edgeCredentials: {
    clientId: process.env.ADOBE_CLIENT_ID,
    clientSecret: process.env.ADOBE_CLIENT_SECRET,
    scopes: process.env.ADOBE_SCOPES.split(",")
  }
});

Neste exemplo, a variável de ambiente ADOBE_SCOPES contém uma lista de escopos separada por vírgulas, como a lista que o Adobe Developer Console mostra para sua credencial.

Validação e erros errors

  • Se edgeCredentials estiver ausente, configure será rejeitado com um erro que diz que o SDK requer edgeCredentials.
  • Se clientId, clientSecret ou scopes estiver ausente ou vazio, configure será rejeitado com um erro que nomeia a propriedade ausente.
  • configure não verifica se a credencial é válida. O SDK solicita um token de acesso na primeira vez em que envia um evento autenticado. Se o Adobe rejeitar a credencial, esse método será rejeitado com um erro cuja mensagem inclui Failed to acquire an IMS access token.

O SDK substitui clientSecret por [REDACTED] em seus logs de depuração e na configuração retornada por getLibraryInfo.

recommendation-more-help
experience-platform-help-collection