Autenticação do Partner Center

Artigo
09/25/2024

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

O Partner Center usa o Microsoft Entra ID para autenticação. Ao interagir com o módulo do PowerShell, o SDK ou a API do Partner Center, você precisa configurar corretamente um aplicativo do Microsoft Entra e, em seguida, solicitar um token de acesso. Os tokens de acesso obtidos usando apenas a autenticação de aplicativo ou a autenticação de usuário + de aplicativo podem ser usados com o Partner Center. No entanto, há dois itens importantes que precisam ser considerados

Use a autenticação multifator ao acessar a API do Partner Center usando a autenticação de aplicativo + usuário. Para mais informações sobre essa alteração, confira Habilitar o modelo de aplicativo seguro.
Nem todas as operações da API do Partner Center são compatíveis com autenticação somente do aplicativo. Em alguns cenários você precisará usar a autenticação de aplicativo + usuário. No título Pré-requisitos de cada artigo, você encontra a documentação que indica se há suporte para autenticação somente de aplicativo, aplicativo + autenticação de usuário ou ambas.

Importante

O Azure Active Directory (Azure AD) Graph foi preterido a partir de 30 de junho de 2023. No futuro, não faremos mais investimentos no Azure AD Graph. As APIs do Graph do Azure AD não têm SLA ou compromisso de manutenção além de correções relacionadas à segurança. Os investimentos nos novos recursos e funcionalidades só serão feitos no Microsoft Graph.

Desativaremos o Azure AD Graph em etapas incrementais para que você tenha tempo suficiente para migrar seus aplicativos para APIs do Microsoft Graph. Em uma data posterior que anunciaremos, bloquearemos a criação de novos aplicativos usando o Azure AD Graph.

Para saber mais, confira Importante: desativação do Azure AD Graph e substituição do módulo do Powershell.

Instalação inicial

Para começar, você precisa verificar se tem uma conta principal do Partner Center e uma conta do Partner Center da área restrita de integração. Para obter mais informações, consulte Configurar contas do Partner Center para acesso à API. Anote a ID de registro e o segredo do aplicativo Microsoft Entra (o segredo do cliente é necessário para a identificação somente do aplicativo) para sua conta principal e sua conta de área restrita de integração.
Entre na ID do Microsoft Entra no portal do Azure. Em permissões para outros aplicativos, defina as permissões para o Microsoft Azure Active Directory para Permissões Delegadas e selecione Acessar o diretório como o usuário conectado e também Entrar e ler o perfil de usuário.
No portal do Azure, selecione Adicionar aplicativo. Pesquise "Microsoft Partner Center", que é o aplicativo do Microsoft Partner Center. Defina as Permissões Delegadas para Acessar a API do Partner Center. Se você estiver usando o Partner Center para Microsoft Cloud for US Government, essa etapa será obrigatória. Se você estiver usando a instância global do Partner Center, essa etapa será opcional. Os parceiros CSP podem usar o recurso Gerenciamento de Aplicativos no Partner Center para ignorar essa etapa para a instância global do Partner Center.

Autenticação somente de aplicativo

Se você quiser usar a autenticação somente de aplicativo para acessar a API REST do Partner Center, a API do .NET, a API do Java ou o módulo do PowerShell, poderá fazer isso usando as instruções a seguir.

.NET (autenticação somente de aplicativo)

public static IAggregatePartner GetPartnerCenterTokenUsingAppCredentials()
{
    IPartnerCredentials partnerCredentials =
        PartnerCredentials.Instance.GenerateByApplicationCredentials(
            PartnerApplicationConfiguration.ApplicationId,
            PartnerApplicationConfiguration.ApplicationSecret,
            PartnerApplicationConfiguration.ApplicationDomain);

    // Create operations instance with partnerCredentials.
    return PartnerService.Instance.CreatePartnerOperations(partnerCredentials);
}

Java (autenticação somente de aplicativo)

O SDK Java do Partner Center pode ser usado para gerenciar recursos do Partner Center. É um projeto de software livre mantido pela comunidade de parceiros e não tem suporte oficial da Microsoft. Caso se depare com um problema, você pode obter ajuda da comunidade ou abrir um problema no GitHub.

public IAggregatePartner getAppPartnerOperations()
{
    IPartnerCredentials appCredentials =
        PartnerCredentials.getInstance().generateByApplicationCredentials(
        PartnerApplicationConfiguration.getApplicationId(),
        PartnerApplicationConfiguration.getApplicationSecret(),
        PartnerApplicationConfiguration.getApplicationDomain());

    return PartnerService.getInstance().createPartnerOperations( appCredentials );
}

REST (autenticação somente de aplicativo)

Solicitação REST

POST https://login.microsoftonline.com/{tenantId}/oauth2/token HTTP/1.1
Accept: application/json
return-client-request-id: true
Content-Type: application/x-www-form-urlencoded; charset=utf-8
Host: login.microsoftonline.com
Content-Length: 194
Expect: 100-continue

resource=https%3A%2F%2Fgraph.windows.net&client_id={client-id-here}&client_secret={client-secret-here}&grant_type=client_credentials

Resposta REST

HTTP/1.1 200 OK
Cache-Control: no-cache, no-store
Pragma: no-cache
Content-Type: application/json; charset=utf-8
Expires: -1
Content-Length: 1406

{"token_type":"Bearer","expires_in":"3600","ext_expires_in":"3600","expires_on":"1546469802","not_before":"1546465902","resource":"https://graph.windows.net","access_token":"value-has-been-removed"}

Autenticação de aplicativo + de usuário

O Modelo de Aplicativo Seguro agora é usado para fornecer autenticação segura, escalonável e preparada para o futuro para acesso à API do Partner Center. Essa abordagem melhora a segurança usando mecanismos de autenticação modernos, como tokens de acesso somente aplicativo e aplicativo+usuário por meio do Azure AD. Para obter mais informações, confira Habilitar o modelo de aplicativo seguro.

O processo de consentimento do parceiro é um processo interativo em que o parceiro se autentica usando a autenticação multifator, consente com o aplicativo e um token de atualização é armazenado em um repositório seguro, como o Azure Key Vault. É recomendável que uma conta dedicada para fins de integração seja usada para esse processo.

Importante

A solução de autenticação multifator apropriada deve ser habilitada para a conta de serviço usada no processo de consentimento do parceiro. Caso não seja, o token de atualização resultante não estará em conformidade com os requisitos de segurança.

Exemplos de autenticação de aplicativo + de usuário

O processo de consentimento do parceiro pode ser executado de várias maneiras. Para ajudar os parceiros a entender como executar cada operação necessária, desenvolvemos os exemplos a seguir. Ao implementar a solução apropriada em seu ambiente, é importante desenvolver uma solução que esteja em conformidade com seus padrões de codificação e políticas de segurança.

.NET (autenticação de aplicativo + de usuário)

O projeto de exemplo de consentimento do parceiro demonstra como utilizar um site desenvolvido usando o ASP.NET para capturar o consentimento, solicitar um token de atualização e armazená-lo com segurança no Azure Key Vault. Execute as etapas a seguir para criar os pré-requisitos necessários para este exemplo.

Crie uma instância do Azure Key Vault usando o portal do Azure ou os comandos do PowerShell a seguir. Antes de executar o comando, você precisa modificar os valores de parâmetro corretamente. O nome do cofre precisa ser exclusivo.
```
Login-AzureRmAccount

# Create a new resource group
New-AzureRmResourceGroup -Name ContosoResourceGroup -Location EastUS

New-AzureRmKeyVault -Name 'Contoso-Vault' -ResourceGroupName 'ContosoResourceGroup' -Location 'East US'
```
Para obter mais informações sobre como criar um Azure Key Vault, consulte Início Rápido: Definir e recuperar um segredo do Azure Key Vault usando o portal do Azure ou Início Rápido: Definir e recuperar um segredo do Azure Key Vault usando o PowerShell. Em seguida, defina e recupere um segredo.

Crie um aplicativo do Microsoft Entra e uma chave usando o portal do Azure ou os comandos a seguir.

Connect-MgGraph -Scopes "Application.ReadWrite.OwnedBy"

$Context = Get-MgContext

$app = New-MgApplication -DisplayName 'My Vault Access App' -Web @{ RedirectUris = 'https://$($Context.TenantId)/$((New-Guid).ToString())' }
$password = Add-MgApplicationPassword -ApplicationId $app.AppId

Write-Host "ApplicationId       = $($app.AppId)"
Write-Host "ApplicationSecret   = $($password.SecretText)"

Anote o identificador do aplicativo e os valores secretos porque eles serão usados nas etapas abaixo.

Conceda ao aplicativo Microsoft Entra recém-criado as permissões de segredos de leitura usando o portal do Azure ou os comandos a seguir.

# Connect to Microsoft Graph
Connect-MgGraph -Scopes "User.Read"

# Get the application
$app = Get-MgApplication -Filter "appId eq 'ENTER-APP-ID-HERE'"

# Set the Key Vault access policy
Set-AzKeyVaultAccessPolicy -VaultName ContosoVault -ObjectId $app.Id -PermissionsToSecrets get

Crie um aplicativo do Microsoft Entra configurado para o Partner Center. Use os procedimentos a seguir para concluir esta etapa.
- Navegue até o recurso de gerenciamento de aplicativos do Partner Center
- Selecione Adicionar novo aplicativo Web para criar um novo aplicativo Microsoft Entra.
Documente os valores de ID do aplicativo, ID da conta* e Chave porque eles serão usados nas etapas abaixo.
Clone o repositório Partner-Center-DotNet-Samples usando o Visual Studio ou o comando a seguir.
```
git clone https://github.com/Microsoft/Partner-Center-DotNet-Samples.git
```
Abra o projeto PartnerConsent encontrado no diretório Partner-Center-DotNet-Samples\secure-app-model\keyvault.

Preencha as configurações do aplicativo encontradas no web.config

<!-- AppID that represents CSP application -->
<add key="ida:CSPApplicationId" value="" />
<!--
    Please use certificate as your client secret and deploy the certificate to your environment.
    The following application secret is for sample application only. please do not use secret directly from the config file.
-->
<add key="ida:CSPApplicationSecret" value="" />

<!--
    Endpoint address for the instance of Azure KeyVault. This is
    the DNS Name for the instance of Key Vault that you provisioned.
 -->
<add key="KeyVaultEndpoint" value="" />

<!-- App ID that is given access for KeyVault to store refresh tokens -->
<add key="ida:KeyVaultClientId" value="" />

<!--
    Please use certificate as your client secret and deploy the certificate
    to your environment. The following application secret is for sample
    application only. please do not use secret directly from the config file.
-->
<add key="ida:KeyVaultClientSecret" value="" />

Importante

Informações confidenciais, como segredos do aplicativo, não devem ser armazenadas em arquivos de configuração. Isso foi feito aqui porque este é um aplicativo de exemplo. Com seu aplicativo de produção, é altamente recomendável que você use a autenticação baseada em certificado. Para obter mais informações, confira Credenciais de certificado para autenticação de aplicativos.

Quando você executa esse projeto de exemplo, ele solicita autenticação. Após a autenticação bem-sucedida, um token de acesso é solicitado da ID do Microsoft Entra. As informações retornadas da ID do Microsoft Entra incluem um token de atualização armazenado na instância configurada do Azure Key Vault.

Java (autenticação de aplicativo + de usuário)

O projeto de exemplo de consentimento do parceiro demonstra como utilizar um site desenvolvido usando JSP para capturar o consentimento, solicitar um token de atualização e armazená-lo com segurança no Azure Key Vault. Execute os procedimentos a seguir para criar os pré-requisitos necessários para este exemplo.

Crie uma instância do Azure Key Vault usando o portal do Azure ou os comandos do PowerShell a seguir. Antes de executar o comando, você precisa modificar os valores de parâmetro corretamente. O nome do cofre precisa ser exclusivo.
```
Login-AzureRmAccount

# Create a new resource group
New-AzureRmResourceGroup -Name ContosoResourceGroup -Location EastUS

New-AzureRmKeyVault -Name 'Contoso-Vault' -ResourceGroupName 'ContosoResourceGroup' -Location 'East US'
```
Para obter mais informações sobre como criar um Azure Key Vault, consulte Início Rápido: Definir e recuperar um segredo do Azure Key Vault usando o portal do Azure ou Início Rápido: Definir e recuperar um segredo do Azure Key Vault usando o PowerShell.

Crie um aplicativo do Microsoft Entra e uma chave usando o portal do Azure ou os comandos a seguir.

Connect-MgGraph -Scopes "Application.ReadWrite.OwnedBy"

$Context = Get-MgContext

$app = New-MgApplication -DisplayName 'My Vault Access App' -IdentifierUri 'https://$($Context.TenantDomain)/$((New-Guid).ToString())'
$password = Add-MgApplicationPassword -ApplicationId $app.AppId

Write-Host "ApplicationId       = $($app.AppId)"
Write-Host "ApplicationSecret   = $($password.SecretText)"

Documente o identificador do aplicativo e os valores secretos porque eles serão usados nas etapas abaixo.

Conceda ao aplicativo Microsoft Entra recém-criado as permissões de segredos de leitura usando o portal do Azure ou os comandos a seguir.

Connect-MgGraph -Scopes "User.Read"
$app = Get-MgApplication -Filter "appId eq 'ENTER-APP-ID-HERE'"

Set-AzKeyVaultAccessPolicy -VaultName ContosoVault -ObjectId $app.Id -PermissionsToSecrets get

Crie um aplicativo do Microsoft Entra configurado para o Partner Center. Execute os procedimentos a seguir para concluir esta etapa.
- Navegue até o recurso de gerenciamento de aplicativos do Partner Center
- Selecione Adicionar novo aplicativo Web para criar um novo aplicativo Microsoft Entra.
Documente os valores de ID do aplicativo, ID da conta* e Chave porque eles serão usados nas etapas abaixo.

Clone o repositório Partner-Center-Java-Samples usando o comando a seguir

git clone https://github.com/Microsoft/Partner-Center-Java-Samples.git

Abra o projeto PartnerConsent encontrado no diretório Partner-Center-Java-Samples\secure-app-model\keyvault.

Preencha as configurações do aplicativo encontradas no arquivo web.xml

<filter>
    <filter-name>AuthenticationFilter</filter-name>
    <filter-class>com.microsoft.store.samples.partnerconsent.security.AuthenticationFilter</filter-class>
    <init-param>
        <param-name>client_id</param-name>
        <param-value></param-value>
    </init-param>
    <init-param>
        <param-name>client_secret</param-name>
        <param-value></param-value>
    </init-param>
    <init-param>
        <param-name>keyvault_base_url</param-name>
        <param-value></param-value>
    </init-param>
    <init-param>
        <param-name>keyvault_client_id</param-name>
        <param-value></param-value>
    </init-param>
    <init-param>
        <param-name>keyvault_client_secret</param-name>
        <param-value></param-value>
    </init-param>
    <init-param>
        <param-name>keyvault_certifcate_path</param-name>
        <param-value></param-value>
    </init-param>
</filter>

Importante

Informações confidenciais, como segredos do aplicativo, não devem ser armazenadas em arquivos de configuração. Isso foi feito aqui porque este é um aplicativo de exemplo. Com seu aplicativo de produção, é altamente recomendável que você use a autenticação baseada em certificado. Confira Autenticação de certificado do Key Vault para obter mais informações.

Quando você executa esse projeto de exemplo, ele solicita autenticação. Após a autenticação bem-sucedida, um token de acesso é solicitado da ID do Microsoft Entra. As informações retornadas da ID do Microsoft Entra incluem um token de atualização armazenado na instância configurada do Azure Key Vault.

Autenticação de Provedor de Soluções na Nuvem

Parceiros do Provedor de Soluções na Nuvem podem usar o token de atualização obtido por meio do processo de consentimento do parceiro.

Exemplos para autenticação de Provedor de Soluções na Nuvem

Para ajudar os parceiros a entender como executar cada operação necessária, desenvolvemos os exemplos a seguir. Ao implementar a solução apropriada em seu ambiente, é importante desenvolver uma solução que esteja em conformidade com seus padrões de codificação e políticas de segurança.

.NET (autenticação do CSP)

Se você ainda não tiver feito isso, execute o processo de consentimento do parceiro.
Clone o repositório Partner-Center-DotNet-Samples usando o Visual Studio ou o comando a seguir
```
git clone https://github.com/Microsoft/Partner-Center-DotNet-Samples.git
```
Abra o projeto CSPApplication encontrado no diretório Partner-Center-DotNet-Samples\secure-app-model\keyvault.

Atualize as configurações do aplicativo encontradas no arquivo App.config.

<!-- AppID that represents CSP application -->
<add key="ida:CSPApplicationId" value="" />
<!--
    Please use certificate as your client secret and deploy the certificate to your environment.
    The following application secret is for sample application only. please do not use secret directly from the config file.
-->
<add key="ida:CSPApplicationSecret" value="" />

<!-- Endpoint address for the instance of Azure KeyVault -->
<add key="KeyVaultEndpoint" value="" />

<!-- AppID that is given access for keyvault to store the refresh tokens -->
<add key="ida:KeyVaultClientId" value="" />

<!--
    Please use certificate as your client secret and deploy the certificate to your environment.
    The following application secret is for sample application only. please do not use secret directly from the config file.
-->
<add key="ida:KeyVaultClientSecret" value="" />

Defina os valores apropriados para as variáveis PartnerId e CustomerId encontradas no arquivo Program.cs.

// The following properties indicate which partner and customer context the calls are going to be made.
string PartnerId = "<Partner tenant id>";
string CustomerId = "<Customer tenant id>";

Quando você executa este projeto de exemplo, ele obtém o token de atualização obtido durante o processo de consentimento do parceiro. Em seguida, ele solicita um token de acesso para interagir com o SDK do Partner Center em nome do parceiro. Por fim, ele solicita um token de acesso para interagir com Microsoft Graph em nome do cliente especificado.

Java (autenticação do CSP)

Se você ainda não tiver feito isso, execute o processo de consentimento do parceiro.
Clone o repositório Partner-Center-Java-Samples usando o Visual Studio ou o comando a seguir
```
git clone https://github.com/Microsoft/Partner-Center-Java-Samples.git
```
Abra o projeto cspsample encontrado no diretório Partner-Center-Java-Samples\secure-app-model\keyvault.

Atualize as configurações do aplicativo encontradas no arquivo application.properties.

azuread.authority=https://login.microsoftonline.com
keyvault.baseurl=
keyvault.clientId=
keyvault.clientSecret=
partnercenter.accountId=
partnercenter.clientId=
partnercenter.clientSecret=

Quando você executa este projeto de exemplo, ele obtém o token de atualização obtido durante o processo de consentimento do parceiro. Em seguida, ele solicita um token de acesso para interagir com o SDK do Partner Center em nome do parceiro.
Opcional – remova as marcas de comentário das chamadas de função RunAzureTask e RunGraphTask se você quiser saber como interagir com o Azure Resource Manager e o Microsoft Graph em nome do cliente.

Autenticação de provedor de painel de controle

Os fornecedores de painel de controle precisam que cada parceiro ao qual eles dão suporte execute o processo de consentimento do parceiro. Após a conclusão desse processo, o token de atualização obtido por meio dele é usado para acessar a API REST do Partner Center e a API do .NET.

Observação

Os fornecedores do painel de controle devem ter, no mínimo, a função de Administrador de aplicativos de nuvem no locatário do cliente.

Exemplos para autenticação de provedor de painel na nuvem

Para ajudar os fornecedores de painéis de controle a entender como executar cada operação necessária, desenvolvemos os exemplos a seguir. Ao implementar a solução apropriada em seu ambiente, é importante desenvolver uma solução que esteja em conformidade com seus padrões de codificação e políticas de segurança.

.NET (autenticação de CPV)

Desenvolva e implante um processo para que parceiros do Provedor de Soluções na Nuvem forneçam o consentimento apropriado. Para obter mais informações e um exemplo, confira consentimento do parceiro.

Importante

As credenciais do usuário de um parceiro do Provedor de Soluções na Nuvem não devem ser armazenadas. O token de atualização obtido por meio do processo de consentimento do parceiro deve ser armazenado e usado para solicitar tokens de acesso para interagir com qualquer API da Microsoft.
Clone o repositório Partner-Center-DotNet-Samples usando o Visual Studio ou o comando a seguir
```
git clone https://github.com/Microsoft/Partner-Center-DotNet-Samples.git
```
Abra o projeto CPVApplication encontrado no diretório Partner-Center-DotNet-Samples\secure-app-model\keyvault.

Atualize as configurações do aplicativo encontradas no arquivo App.config.

<!-- AppID that represents Control panel vendor application -->
<add key="ida:CPVApplicationId" value="" />

<!--
    Please use certificate as your client secret and deploy the certificate to your environment.
    The following application secret is for sample application only. please do not use secret directly from the config file.
-->
<add key="ida:CPVApplicationSecret" value="" />

<!-- Endpoint address for the instance of Azure KeyVault -->
<add key="KeyVaultEndpoint" value="" />

<!-- AppID that is given access for keyvault to store the refresh tokens -->
<add key="ida:KeyVaultClientId" value="" />

<!--
    Please use certificate as your client secret and deploy the certificate to your environment.
    The following application secret is for sample application only. please do not use secret directly from the config file.
-->
<add key="ida:KeyVaultClientSecret" value="" />

Defina os valores apropriados para as variáveis PartnerId e CustomerId encontradas no arquivo Program.cs.

// The following properties indicate which partner and customer context the calls are going to be made.
string PartnerId = "<Partner tenant id>";
string CustomerId = "<Customer tenant id>";

Quando você executa esse projeto de exemplo, ele obtém o token de atualização para o parceiro especificado. Em seguida, ele solicita um token de acesso para acessar o Partner Center e o Microsoft Graph em nome do parceiro. A próxima tarefa que ele executa é a exclusão e a criação de concessões de permissão no locatário do cliente. Já que não há nenhuma relação entre o fornecedor de painel de controle e o cliente, essas permissões precisam ser adicionadas usando a API da Central de Parceiros. O exemplo a seguir mostra como fazer isso.

JObject contents = new JObject
{
    // Provide your application display name
    ["displayName"] = "CPV Marketplace",

    // Provide your application id
    ["applicationId"] = CPVApplicationId,

    // Provide your application grants
    ["applicationGrants"] = new JArray(
        JObject.Parse("{\"enterpriseApplicationId\": \"00000003-0000-0000-c000-000000000000\", \"scope\":\"Domain.ReadWrite.All,User.ReadWrite.All,Directory.Read.All\"}"), // for Microsoft Graph access,  Directory.Read.All
        JObject.Parse("{\"enterpriseApplicationId\": \"797f4846-ba00-4fd7-ba43-dac1f8f63013\", \"scope\":\"user_impersonation\"}")) // for Azure Resource Manager access
};

/**
 * The following steps have to be performed once per customer tenant if your application is
 * a control panel vendor application and requires customer tenant Microsoft Graph access.
 **/

// delete the previous grant into customer tenant
JObject consentDeletion = await ApiCalls.DeleteAsync(
    tokenPartnerResult.Item1,
    string.Format("https://api.partnercenter.microsoft.com/v1/customers/{0}/applicationconsents/{1}", CustomerId, CPVApplicationId));

// create new grants for the application given the setting in application grants payload.
JObject consentCreation = await ApiCalls.PostAsync(
    tokenPartnerResult.Item1,
    string.Format("https://api.partnercenter.microsoft.com/v1/customers/{0}/applicationconsents", CustomerId),
    contents.ToString());

Depois que essas permissões tiverem sido estabelecidas, o exemplo executará operações usando o Microsoft Graph em nome do cliente.

Observação

Para obter mais informações sobre o Microsoft Graph, confira a Visão geral do Microsoft Graph.

Java (autenticação CPV)

Desenvolva e implante um processo para que parceiros do Provedor de Soluções na Nuvem forneçam o consentimento apropriado. Para obter mais informações e um exemplo, confira consentimento do parceiro.

Importante

As credenciais do usuário de um parceiro do Provedor de Soluções na Nuvem não devem ser armazenadas. O token de atualização obtido por meio do processo de consentimento do parceiro deve ser armazenado e usado para solicitar tokens de acesso para interagir com qualquer API da Microsoft.

Clone o repositório Partner-Center-Java-Samples usando o comando a seguir

git clone https://github.com/Microsoft/Partner-Center-Java-Samples.git

Abra o projeto cpvsample encontrado no diretório Partner-Center-Java-Samples\secure-app-model\keyvault.

Atualize as configurações do aplicativo encontradas no arquivo application.properties.

azuread.authority=https://login.microsoftonline.com
keyvault.baseurl=
keyvault.clientId=
keyvault.clientSecret=
partnercenter.accountId=
partnercenter.clientId=
partnercenter.clientSecret=
partnercenter.displayName=

O valor para o partnercenter.displayName deve ser o nome de exibição do seu aplicativo do marketplace.

Defina os valores apropriados para as variáveis partnerId e customerId encontradas no arquivo Program.java.

partnerId = "SPECIFY-THE-PARTNER-TENANT-ID-HERE";
customerId = "SPECIFY-THE-CUSTOMER-TENANT-ID-HERE";

Quando você executa esse projeto de exemplo, ele obtém o token de atualização para o parceiro especificado. Em seguida, ele solicita um token de acesso para acessar o Partner Center em nome do parceiro. A próxima tarefa que ele executa é a exclusão e a criação de concessões de permissão no locatário do cliente. Já que não há nenhuma relação entre o fornecedor de painel de controle e o cliente, essas permissões precisam ser adicionadas usando a API da Central de Parceiros. O exemplo a seguir mostra como conceder as permissões.

ApplicationGrant azureAppGrant = new ApplicationGrant();

azureAppGrant.setEnterpriseApplication("797f4846-ba00-4fd7-ba43-dac1f8f63013");
azureAppGrant.setScope("user_impersonation");

ApplicationGrant graphAppGrant = new ApplicationGrant();

graphAppGrant.setEnterpriseApplication("00000002-0000-0000-c000-000000000000");
graphAppGrant.setScope("Domain.ReadWrite.All,User.ReadWrite.All,Directory.Read.All");

ApplicationConsent consent = new ApplicationConsent();

consent.setApplicationGrants(Arrays.asList(azureAppGrant, graphAppGrant));
consent.setApplicationId(properties.getProperty(PropertyName.PARTNER_CENTER_CLIENT_ID));
consent.setDisplayName(properties.getProperty(PropertyName.PARTNER_CENTER_DISPLAY_NAME));

// Deletes the existing grant into the customer it is present.
partnerOperations.getServiceClient().delete(
    partnerOperations,
    new TypeReference<ApplicationConsent>(){},
    MessageFormat.format(
        "customers/{0}/applicationconsents/{1}",
        customerId,
        properties.getProperty(PropertyName.PARTNER_CENTER_CLIENT_ID)));

// Consent to the defined applications and the respective scopes.
partnerOperations.getServiceClient().post(
    partnerOperations,
    new TypeReference<ApplicationConsent>(){},
    MessageFormat.format(
        "customers/{0}/applicationconsents",
        customerId),
    consent);

Remova as marcas de comentário das chamadas de função RunAzureTask e RunGraphTask se você quiser saber como interagir com o Azure Resource Manager e o Microsoft Graph em nome do cliente.

Compartilhar via

Autenticação do Partner Center

Instalação inicial

Autenticação somente de aplicativo

.NET (autenticação somente de aplicativo)

Java (autenticação somente de aplicativo)

REST (autenticação somente de aplicativo)

Solicitação REST

Resposta REST

Autenticação de aplicativo + de usuário

Exemplos de autenticação de aplicativo + de usuário

.NET (autenticação de aplicativo + de usuário)

Java (autenticação de aplicativo + de usuário)

Autenticação de Provedor de Soluções na Nuvem

Exemplos para autenticação de Provedor de Soluções na Nuvem

.NET (autenticação do CSP)

Java (autenticação do CSP)

Autenticação de provedor de painel de controle

Exemplos para autenticação de provedor de painel na nuvem

.NET (autenticação de CPV)

Java (autenticação CPV)

Comentários

Recursos adicionais

Compartilhar via

Autenticação do Partner Center

Instalação inicial

Autenticação somente de aplicativo

.NET (autenticação somente de aplicativo)

Java (autenticação somente de aplicativo)

REST (autenticação somente de aplicativo)

Solicitação REST

Resposta REST

Autenticação de aplicativo + de usuário

Consentimento do parceiro

Exemplos de autenticação de aplicativo + de usuário

.NET (autenticação de aplicativo + de usuário)

Java (autenticação de aplicativo + de usuário)

Autenticação de Provedor de Soluções na Nuvem

Exemplos para autenticação de Provedor de Soluções na Nuvem

.NET (autenticação do CSP)

Java (autenticação do CSP)

Autenticação de provedor de painel de controle

Exemplos para autenticação de provedor de painel na nuvem

.NET (autenticação de CPV)

Java (autenticação CPV)

Comentários

Recursos adicionais