Configurar o acesso à API no Partner Center

Artigo
11/28/2023

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para o Microsoft Cloud for US Government

Este artigo descreve as contas que você precisa desenvolver em relação ao SDK da Central de Parceiros. Este artigo também explica como criar uma conta de área restrita de integração e testá-la na área restrita de integração.

Observação

Para obter acesso às APIs, seu locatário precisa ser um locatário do CSP e você precisa ser um provedor indireto ou um parceiro de cobrança direto.

Definições de conta

Para ajudá-lo a integrar e testar sua integração de API, o Partner Center oferece suporte a dois tipos de contas:

Conta principal do Partner Center

Nessa conta, você cria pedidos reais para clientes reais. Se você fizer alterações ou transações quando estiver conectado à conta principal, usando o SDK do Partner Center ou a interface do usuário do Painel do parceiro, elas serão tratadas como pedidos oficiais para clientes reais. Eles serão refletidos em sua fatura, e sua empresa é responsável por pagá-los.

Conta da área restrita de integração

Essa conta serve para testar seu código e sua integração com as APIs do Partner Center antes de implantá-lo amplamente. As alterações e transações que você faz quando está conectado à conta da área restrita de integração aparecem em sua fatura. No entanto, você não precisa pagar o valor da fatura. O PDF da fatura terá um aviso de isenção de responsabilidade como "NÃO PAGUE. ESTA É UMA FATURA DE ÁREA RESTRITA E NÃO É NECESSÁRIA NENHUMA AÇÃO."

A conta da área restrita de integração e a conta principal agem de forma independente e não compartilham contas de administrador, contas de usuário, clientes, pedidos, assinaturas ou outros dados.

A área restrita de integração dá suporte a transações com um número limitado de clientes, pedidos, assinaturas, licenças etc.

Por política, as contas de área restrita de integração são apenas para fins de teste de integração.

Por padrão, não há nenhuma conta da área restrita de integração configurada. Você deverá criar uma sozinho se quiser usar o SDK do Partner Center.

Configurar suas contas

Esta seção descreve como configurar uma conta principal do Partner Center e uma conta de área restrita de integração para o SDK do Partner Center.

Criar uma área restrita de integração

Entre no Partner Center com uma conta de administrador global e selecione Configurações (engrenagem).

Observação

A criação de uma Sandbox requer que o administrador global do parceiro esteja conectado ao Partner Center com seu alias de domínio onmicrosoft.com (por exemplo, alias@domain.onmicrosoft.com). A criação da área restrita falhará se o usuário estiver conectado com seu domínio personalizado.
Selecione Configurações da conta e, em seguida , Área restrita de integração.

Observação

Se você não vir uma opção de área restrita de integração, talvez você não tenha uma conta do administrador global. Também é possível que você esteja usando uma conta de área restrita de integração quando uma área restrita de integração já foi configurada.
Insira as informações de contato da conta do administrador da área restrita de integração. Em seguida, escolha Criar conta. Aguarde alguns minutos para receber uma mensagem de confirmação de que a conta foi criada.
Depois de ver a mensagem de confirmação, saia do Painel do Partner Center.
Entre novamente com sua nova conta do administrador da área restrita da integração. Use o formato nomedeusuario@dominio para suas credenciais junto com a senha que você especificou.
Escolha Configurar conta na página Área restrita de integração para concluir a configuração da conta de área restrita.

Habilitar acesso à API

Depois que sua conta estiver configurada, você deverá habilitar o acesso à API antes de usar o SDK do Partner Center com a área restrita de integração. Você precisa permitir o acesso à API separadamente para sua conta principal do Partner Center e sua conta da área restrita de integração.

Entre no Partner Center com uma conta de administrador global e selecione Configurações (engrenagem).
Selecione Configurações da conta e, em seguida , Gerenciamento de aplicativos.
Se você ainda não tiver um aplicativo existente, adicione um novo aplicativo Web. Se você tiver um aplicativo Web existente, escolha o botão Adicionar chave.
Copie as informações de registro do aplicativo (especialmente a Chave, caso você esteja criando um aplicativo Web) e, em seguida, armazene-as em um local seguro.
Saia do Painel do Parceiro.
Entre novamente com sua conta da área restrita de integração. Repita as etapas 2 a 5 para habilitar o acesso à API na área restrita de integração.

Escrever e testar código

Você pode escrever código e testá-lo na área restrita de integração. Você precisará das informações a seguir para configurar a autenticação do Partner Center com o Microsoft Entra ID.

Nome do item	Local do item
ID do aplicativo / ID do cliente	Em Configurações (engrenagem), selecione Configurações da conta e, em seguida, Gerenciamento de aplicativos. A ID do aplicativo/ID do cliente está listada como a ID do aplicativo de um aplicativo registrado.
Chave	Se você criou um aplicativo Web na seção Habilitar o acesso à API, essa é a chave que você salvou na etapa 5.
Domínio	O domínio para a área restrita de integração.

Executar código testado

Para usar sua solução com dados de clientes reais, você deve alterar suas credenciais de área restrita de integração para suas credenciais de conta principal do Partner Center.

Quando estiver pronto para usar seu código testado em sua conta de parceiro principal, você deverá obter um token de segurança do Microsoft Entra. Esse token de segurança é baseado no aplicativo, na chave e no domínio do Partner Center (em vez do aplicativo, da chave e do domínio da área restrita de integração).

Siga as etapas na autenticação do Partner Center para obter um token de segurança do Microsoft Entra usando suas credenciais principais do Partner Center. (Você seguiu estas etapas anteriormente para obter um token de segurança do Microsoft Entra para sua área restrita de integração.)
Substitua o token de segurança de integração em seu código pelo novo token de segurança para sua conta principal do Partner Center.