Troubleshoot publisher verification

If you're unable to complete the process or are experiencing unexpected behavior with publisher verification, you should start by doing the following if you're receiving errors or seeing unexpected behavior:

  1. Review the requirements and ensure they've all been met.
  2. Review the instructions to mark an app as publisher verified and ensure all steps have been performed successfully.
  3. Review the list of common issues.
  4. Reproduce the request using Graph Explorer to gather more info and rule out any issues in the UI.

Common Issues

Below are some common issues that may occur during the process.

  • I don’t know my Cloud Partner Program ID (Partner One ID) or I don’t know who the primary contact for the account is.

    1. Navigate to the Cloud Partner Program enrollment page.
    2. Sign in with a user account in the org's primary Microsoft Entra tenant.
    3. If a Cloud Partner Program account already exists, this is recognized and you are added to the account.
    4. Navigate to the partner profile page where the Partner One ID and primary account contact will be listed.
  • I don’t know who my Microsoft Entra Global Administrator (also known as company admin or tenant admin) is, how do I find them? What about the Application Administrator or Cloud Application Administrator?

    1. Sign in to the Microsoft Entra admin center as at least an Cloud Application Adminstrator.
    2. Browse to Identity > Roles & admins > Roles & admins.
    3. Select the desired admin role.
    4. The list of users assigned that role will be displayed.
  • I don't know who the admin(s) for my CPP account are Go to the CPP User Management page and filter the user list to see what users are in various admin roles.

  • I am getting an error saying that my Partner One ID is invalid or that I do not have access to it. Follow the remediation guidance.

  • When I sign in to the Microsoft Entra admin center, I do not see any apps registered. Why? Your app registrations may have been created using a different user account in this tenant, a personal/consumer account, or in a different tenant. Ensure you're signed in with the correct account in the tenant where your app registrations were created.

  • I'm getting an error related to multi-factor authentication. What should I do? Ensure multifactor authentication is enabled and required for the user you're signing in with and for this scenario. For example, MFA could be:

Making Microsoft Graph API calls

If you're having an issue but unable to understand why based on what you are seeing in the UI, it may be helpful to perform further troubleshooting by using Microsoft Graph calls to perform the same operations you can perform in the App Registration portal.

The easiest way to make these requests is to use Graph Explorer. You may also consider other options like using Postman, or using PowerShell to invoke a web request.

You can use Microsoft Graph to both set and unset your app’s verified publisher and check the result after performing one of these operations. The result can be seen on both the application object corresponding to your app registration and any service principals that have been instantiated from that app. For more information on the relationship between those objects, see: Application and service principal objects in Microsoft Entra ID.

Here are examples of some useful requests:

Set Verified Publisher

Request

POST /applications/0cd04273-0d11-4e62-9eb3-5c3971a7cbec/setVerifiedPublisher 

{ 

    "verifiedPublisherId": "12345678" 

} 

Response

204 No Content 

Note

verifiedPublisherID is your Partner One ID.

Unset Verified Publisher

Request:

POST /applications/0cd04273-0d11-4e62-9eb3-5c3971a7cbec/unsetVerifiedPublisher 

Response

204 No Content 

Get Verified Publisher info from Application

GET https://graph.microsoft.com/v1.0/applications/0cd04273-0d11-4e62-9eb3-5c3971a7cbec 

HTTP/1.1 200 OK 

{ 
    "id": "0cd04273-0d11-4e62-9eb3-5c3971a7cbec", 

    ... 

    "verifiedPublisher" : { 
        "displayName": "myexamplePublisher", 
        "verifiedPublisherId": "12345678", 
        "addedDateTime": "2019-12-10T00:00:00" 
    } 
} 

Get Verified Publisher info from Service Principal

GET https://graph.microsoft.com/v1.0/servicePrincipals/010422a7-4d77-4f40-9335-b81ef5c23dd4 

HTTP/1.1 200 OK 

{ 
    "id": "010422a7-4d77-4f40-9335-b81ef5c22dd4", 

    ... 

    "verifiedPublisher" : { 
        "displayName": "myexamplePublisher", 
        "verifiedPublisherId": "12345678", 
        "addedDateTime": "2019-12-10T00:00:00" 
    } 
} 

Error Reference

The following is a list of the potential error codes you may receive, either when troubleshooting with Microsoft Graph or going through the process in the app registration portal.

MPNAccountNotFoundOrNoAccess

The Partner One ID you provided (MPNID) doesn't exist, or you don't have access to it. Provide a valid Partner One ID and try again.

Most commonly caused by the signed-in user not being a member of the proper role for the CPP account in Partner Center- see requirements for a list of eligible roles and see common issues for more information. Can also be caused by the tenant the app is registered in not being added to the CPP account, or an invalid Partner One ID.

Remediation Steps

  1. Go to your partner profile and verify that:

    • The Partner One ID is correct.
    • There are no errors or "pending actions" shown, and the verification status under Legal business profile and Partner info both say "authorized" or "success".
  2. Go to the CPP tenant management page and confirm that the tenant the app is registered in and that you're signing with a user account from is on the list of associated tenants. To add another tenant, follow the multi-tenant-account instructions. All Global Admins of any tenant you add will be granted Global Administrator privileges on your Partner Center account.

  3. Go to the CPP User Management page and confirm the user you're signing in as is either a Global Administrator, MPN Admin, or Accounts Admin. To add a user to a role in Partner Center, follow the instructions for creating user accounts and setting permissions.

MPNGlobalAccountNotFound

The Partner One ID you provided (MPNID) isn't valid. Provide a valid Partner One ID and try again.

Most commonly caused when a Partner One ID is provided which corresponds to a Partner Location Account (PLA). Only Partner Global Accounts are supported. See Partner Center account structure for more details.

Remediation Steps

  1. Navigate to your partner profile > Identifiers blade > Microsoft Cloud Partners Program Tab.
  2. Use the Partner ID with type PartnerGlobal.

MPNAccountInvalid

The Partner One ID you provided (MPNID) isn't valid. Provide a valid Partner One ID and try again.

Most commonly caused by the wrong Partner One ID being provided.

Remediation Steps

  1. Navigate to your partner profile > Identifiers blade > Microsoft Cloud Partners Program Tab.
  2. Use the Partner ID with type PartnerGlobal.

MPNAccountNotVetted

The Partner One ID (MPNID) you provided hasn't completed the vetting process. Complete this process in Partner Center and try again.

Most commonly caused by when the CPP account hasn't completed the verification process.

Remediation Steps

  1. Navigate to your partner profile and verify that there are no errors or pending actions shown, and that the verification status under Legal business profile and Partner info both say authorized or success.
  2. If not, view pending action items in Partner Center and troubleshoot with here.

NoPublisherIdOnAssociatedMPNAccount

The Partner One ID you provided (MPNID) isn't valid. Provide a valid Partner One ID and try again.

Most commonly caused by the wrong Partner One ID being provided.

Remediation Steps

  1. Navigate to your partner profile > Identifiers blade > Microsoft Cloud Partners Program Tab.
  2. Use the Partner ID with type PartnerGlobal.

MPNIdDoesNotMatchAssociatedMPNAccount

The Partner One ID you provided (MPNID) isn't valid. Provide a valid Partner One ID and try again.

Most commonly caused by the wrong Partner One ID being provided.

Remediation Steps

  1. Navigate to your partner profile > Identifiers blade > Microsoft Cloud Partners Program Tab.
  2. Use the Partner ID with type PartnerGlobal.

ApplicationNotFound

The target application (AppId) can't be found. Provide a valid application ID and try again.

Most commonly caused when verification is being performed via Graph API, and the ID of the application provided is incorrect.

Remediation Steps

  1. The Object ID of the application must be provided, not the AppId/ClientId. See id on the list of application properties here.
  2. Sign in to the Microsoft Entra admin center as at least an Cloud Application Administrator.
  3. Browse to Identity > Applications > Application registrations.
  4. Find your app's registration to view the Object ID.

ApplicationObjectisInvalid

The target application's object ID is invalid. Provide a valid ID and try again.

Most commonly caused when the verification is being performed via Graph API, and the ID of the application provided does not exist.

Remediation Steps

  1. The Object ID of the application must be provided, not the AppId/ClientId. See id on the list of application properties here.
  2. Sign in to the Microsoft Entra admin center as at least an Cloud Application Administrator.
  3. Browse to Identity > Applications > Application registrations.
  4. Find your app's registration to view the Object ID.

B2CTenantNotAllowed

This capability isn't supported in an Azure AD B2C tenant.

EmailVerifiedTenantNotAllowed

This capability isn't supported in an email verified tenant.

NoPublisherDomainOnApplication

The target application (AppId) must have a Publisher Domain set. Set a Publisher Domain and try again.

Occurs when a Publisher Domain isn't configured on the app.

Remediation Steps Follow the directions here to set a Publisher Domain.

PublisherDomainMismatch

The target application's Publisher Domain (publisherDomain) either doesn't match the domain used to perform email verification in Partner Center (pcDomain) or has not been verified. Ensure these domains match and have been verified then try again.

Occurs when neither the app's Publisher Domain nor one of the custom domains added to the Microsoft Entra tenant match the domain used to perform email verification in Partner Center or has not been verified.

See requirements for a list of allowed domain or sub-domain matches.

Remediation Steps

  1. Navigate to your partner profile, and view the email listed as Primary Contact
  2. The domain used to perform email verification in Partner Center is the portion after the "@" in the Primary Contact's email
  3. Sign in to the Microsoft Entra admin center as at least an Cloud Application Administrator.
  4. Browse to Identity > Applications > Application registrations > Branding and Properties.
  5. Select Update Publisher Domain and follow the instructions to Verify a New Domain.
  6. Add the domain used to perform email verification in Partner Center as a New Domain.

NotAuthorizedToVerifyPublisher

You aren't authorized to set the verified publisher property on application (<AppId).

Most commonly caused by the signed-in user not being a member of the proper role for the CPP account in Microsoft Entra ID - see requirements for a list of eligible roles and see common issues for more information.

Remediation Steps

  1. Sign in to the Microsoft Entra admin center as at least an Cloud Application Administrator.
  2. Browse to Identity > Applications > Roles & admins > Roles & admins.
  3. Select the desired admin role and select Add Assignment if you have sufficient permissions.
  4. If you do not have sufficient permissions, contact an admin role for assistance.

MPNIdWasNotProvided

The Partner One ID wasn't provided in the request body or the request content type wasn't "application/json".

Most commonly caused when the verification is being performed via Graph API, and the Partner One ID wasn’t provided in the request.

Remediation Steps

  1. Navigate to your partner profile > Identifiers blade > Microsoft Cloud Partners Program Tab.
  2. Use the Partner ID with type PartnerGlobal in the request.

MSANotSupported

This feature isn't supported for Microsoft consumer accounts. Only applications registered in Microsoft Entra ID by a Microsoft Entra user are supported.

Occurs when a consumer account is used for app registration (Hotmail, Messenger, OneDrive, MSN, Xbox Live, or Microsoft 365).

InteractionRequired

Occurs when multifactor authentication (MFA) hasn't been enabled and performed before attempting to add a verified publisher to the app. See common issues for more information. Note: MFA must be performed in the same session when attempting to add a verified publisher. If MFA is enabled but not required to be performed in the session, the request fails.

The error message displayed will be: "Due to a configuration change made by your administrator, or because you moved to a new location, you must use multifactor authentication to proceed."

Remediation Steps

  1. Ensure multifactor authentication is enabled and required for the user you're signing in with and for this scenario
  2. Retry Publisher Verification

UserUnableToAddPublisher

Error: "You're unable to add a verified publisher to this application. Contact your administrator for assistance."

When a request to add a verified publisher is made, many signals are used to make a security risk assessment. If the user risk state is determined to be ‘AtRisk’, the above error will be returned. Investigate the user risk and take the appropriate steps to remediate the risk (guidance below):

Remediation Steps

Investigate risk

Remediate risk/unblock users

Self-remediation guidance

Self-serve password reset (SSPR): If the organization allows SSPR, use aka.ms/sspr to reset the password for remediation. Please choose a strong password; Choosing a weak password may not reset the risk state.

Note

Please give some time after remediation for the risk state to update, and then try again.

UnableToAddPublisher

Error: "A verified publisher cannot be added to this application. Please contact your administrator for assistance."

When a request to add a verified publisher is made, many signals are used to make a security risk assessment. If a request is determined to be risky, the above error will be returned. For security reasons, Microsoft doesn't disclose the specific criteria used to determine whether a request is risky or not.

Remediation Steps

If you believe the "risky" assessment is incorrect, try resubmitting the verification request the next day. It may take some time for the risk state to update.

Next steps

If you've reviewed all of the previous information and are still receiving an error from Microsoft Graph, gather as much of the following information as possible related to the failing request and contact Microsoft support.

  • Timestamp
  • CorrelationId
  • ObjectID or UserPrincipalName of signed in user
  • ObjectId of target application
  • AppId of target application
  • TenantId where app is registered
  • Partner One ID
  • REST request being made
  • Error code and message being returned