Skip to content

Commit d592df4

Browse files
authored
Merge pull request #106359 from xurobertMSFT/patch-3
Update troubleshoot-publisher-verification.md
2 parents d35e607 + c8aecd0 commit d592df4

File tree

1 file changed

+72
-14
lines changed

1 file changed

+72
-14
lines changed

articles/active-directory/develop/troubleshoot-publisher-verification.md

Lines changed: 72 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -44,11 +44,7 @@ Below are some common issues that may occur during the process.
4444
Go to the [MPN User Management page](https://partner.microsoft.com/pcv/users) and filter the user list to see what users are in various admin roles.
4545

4646
- **I am getting an error saying that my MPN ID is invalid or that I do not have access to it.**
47-
1. Go to your [partner profile](https://partner.microsoft.com/pcv/accountsettings/connectedpartnerprofile) and verify that:
48-
- The MPN ID is correct.
49-
- There are no errors or “pending actions” shown, and the verification status under Legal business profile and Partner info both say “authorized” or “success”.
50-
2. Go to the [MPN tenant management page](https://partner.microsoft.com/dashboard/account/v3/tenantmanagement) 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 instructions [here](/partner-center/multi-tenant-account). Be aware that all Global Admins of any tenant you add will be granted Global Administrator privileges on your Partner Center account.
51-
3. Go to the [MPN User Management page](https://partner.microsoft.com/pcv/users) 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 [here](/partner-center/create-user-accounts-and-set-permissions).
47+
Follow the [remediation guidance](#mpnaccountnotfoundornoaccess).
5248

5349
- **When I sign into the Azure portal, I do not see any apps registered. Why?**
5450
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.
@@ -150,53 +146,88 @@ The MPN ID you provided (`MPNID`) doesn't exist, or you don't have access to it.
150146

151147
Most commonly caused by the signed-in user not being a member of the proper role for the MPN account in Partner Center- see [requirements](publisher-verification-overview.md#requirements) for a list of eligible roles and see [common issues](#common-issues) for more information. Can also be caused by the tenant the app is registered in not being added to the MPN account, or an invalid MPN ID.
152148

149+
**Remediation Steps**
150+
1. Go to your [partner profile](https://partner.microsoft.com/pcv/accountsettings/connectedpartnerprofile) and verify that:
151+
152+
- The MPN ID is correct.
153+
- There are no errors or “pending actions” shown, and the verification status under Legal business profile and Partner info both say “authorized” or “success”.
154+
2. Go to the [MPN tenant management page](https://partner.microsoft.com/dashboard/account/v3/tenantmanagement) 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](/partner-center/multi-tenant-account). Be aware that all Global Admins of any tenant you add will be granted Global Administrator privileges on your Partner Center account.
155+
3. Go to the [MPN User Management page](https://partner.microsoft.com/pcv/users) 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](/partner-center/create-user-accounts-and-set-permissions).
156+
153157
### MPNGlobalAccountNotFound
154158

155159
The MPN ID you provided (`MPNID`) isn't valid. Provide a valid MPN ID and try again.
156160

157161
Most commonly caused when an MPN ID is provided which corresponds to a Partner Location Account (PLA). Only Partner Global Accounts are supported. See [Partner Center account structure](/partner-center/account-structure) for more details.
158162

163+
**Remediation Steps**
164+
1. Navigate to your [partner profile](https://partner.microsoft.com/pcv/accountsettings/connectedpartnerprofile) > Identifiers blade > Microsoft Cloud Partners Program Tab
165+
2. Use the Partner ID with type PartnerGlobal
166+
159167
### MPNAccountInvalid
160168

161169
The MPN ID you provided (`MPNID`) isn't valid. Provide a valid MPN ID and try again.
162170

163171
Most commonly caused by the wrong MPN ID being provided.
164172

173+
**Remediation Steps**
174+
1. Navigate to your [partner profile](https://partner.microsoft.com/pcv/accountsettings/connectedpartnerprofile) > Identifiers blade > Microsoft Cloud Partners Program Tab
175+
2. Use the Partner ID with type PartnerGlobal
176+
165177
### MPNAccountNotVetted
166178

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

169181
Most commonly caused by when the MPN account hasn't completed the [verification](/partner-center/verification-responses) process.
170182

183+
**Remediation Steps**
184+
1. Navigate to your [partner profile](https://partner.microsoft.com/pcv/accountsettings/connectedpartnerprofile) 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**.
185+
2. If not, view pending action items in Partner Center and troubleshoot with [here](/partner-center/verification-responses)
186+
171187
### NoPublisherIdOnAssociatedMPNAccount
172188

173189
The MPN ID you provided (`MPNID`) isn't valid. Provide a valid MPN ID and try again.
174190

175191
Most commonly caused by the wrong MPN ID being provided.
176192

193+
**Remediation Steps**
194+
1. Navigate to your [partner profile](https://partner.microsoft.com/pcv/accountsettings/connectedpartnerprofile) > Identifiers blade > Microsoft Cloud Partners Program Tab
195+
2. Use the Partner ID with type PartnerGlobal
196+
177197
### MPNIdDoesNotMatchAssociatedMPNAccount
178198

179199
The MPN ID you provided (`MPNID`) isn't valid. Provide a valid MPN ID and try again.
180200

181201
Most commonly caused by the wrong MPN ID being provided.
182202

203+
**Remediation Steps**
204+
1. Navigate to your [partner profile](https://partner.microsoft.com/pcv/accountsettings/connectedpartnerprofile) > Identifiers blade > Microsoft Cloud Partners Program Tab
205+
2. Use the Partner ID with type PartnerGlobal
206+
183207
### ApplicationNotFound
184208

185209
The target application (`AppId`) can’t be found. Provide a valid application ID and try again.
186210

187-
Most commonly caused when verification is being performed via Graph API, and the ID of the application provided is incorrect. Note that the ID of the application must be provided, not the AppId/ClientId.
211+
Most commonly caused when verification is being performed via Graph API, and the ID of the application provided is incorrect.
212+
213+
**Remediation Steps**
214+
1. The Object ID of the application must be provided, not the AppId/ClientId. See **id** on the list of application properties [here](/graph/api/resources/application)
215+
2. Log in to [Azure Active Directory](https://aad.portal.azure.com/) with a user account in your organization's primary tenant > Azure Active Directory > App Registrations blade
216+
3. Find your app's registration to view the Object ID
217+
188218

189219
### ApplicationObjectisInvalid
190220

191221
The target application's object ID is invalid. Please provide a valid ID and try again.
192222

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

195-
> [!NOTE]
196-
> The Object ID of the application must be provided, not the AppId/ClientId. See "id" on the list of application properties at [application resource type - Microsoft Graph v1.0 | Microsoft Learn](/graph/api/resources/application).
225+
**Remediation Steps**
226+
1. The Object ID of the application must be provided, not the AppId/ClientId. See **id** on the list of application properties [here](/graph/api/resources/application)
227+
2. Log in to [Azure Active Directory](https://aad.portal.azure.com/) with a user account in your organization's primary tenant > Azure Active Directory > App Registrations blade
228+
3. Find your app's registration to view the Object ID
197229

198230

199-
200231
### B2CTenantNotAllowed
201232

202233
This capability isn't supported in an Azure AD B2C tenant.
@@ -211,6 +242,9 @@ The target application (`AppId`) must have a Publisher Domain set. Set a Publish
211242

212243
Occurs when a [Publisher Domain](howto-configure-publisher-domain.md) isn't configured on the app.
213244

245+
**Remediation Steps**
246+
1. Follow the directions [here](/azure/active-directory/develop/howto-configure-publisher-domain#set-a-publisher-domain-in-the-azure-portal) to set a Publisher Domain
247+
214248
### PublisherDomainMismatch
215249

216250
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.
@@ -219,18 +253,37 @@ Occurs when neither the app's [Publisher Domain](howto-configure-publisher-domai
219253

220254
See [requirements](publisher-verification-overview.md) for a list of allowed domain or sub-domain matches.
221255

256+
**Remediation Steps**
257+
1. Navigate to your [partner profile](https://partner.microsoft.com/pcv/accountsettings/connectedpartnerprofile), and view the email listed as Primary Contact
258+
2. The domain used to perform email verification in Partner Center is the portion after the “@” in the Primary Contact’s email
259+
3. Log in to [Azure Active Directory](https://aad.portal.azure.com/) > Azure Active Directory > App Registrations blade > (`Your App`) > Branding and Properties
260+
4. Select **Update Publisher Domain** and follow the instructions to **Verify a New Domain**.
261+
5. Add the domain used to perform email verification in Partner Center as a New Domain
262+
263+
222264
### NotAuthorizedToVerifyPublisher
223265

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

226268
Most commonly caused by the signed-in user not being a member of the proper role for the MPN account in Azure AD- see [requirements](publisher-verification-overview.md#requirements) for a list of eligible roles and see [common issues](#common-issues) for more information.
227269

270+
**Remediation Steps**
271+
1. Sign in to the [Azure AD Portal](https://aad.portal.azure.com) using a user account in your organization's primary tenant.
272+
2. Navigate to [Role Management](https://aad.portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RolesAndAdministrators).
273+
3. Select the desired admin role and click “Add Assignment” if you have sufficient permissions.
274+
4. If you do not have sufficient permissions, contact an admin role for assistance
275+
276+
228277
### MPNIdWasNotProvided
229278

230279
The MPN ID wasn't provided in the request body or the request content type wasn't "application/json".
231280

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

283+
**Remediation Steps**
284+
1. Navigate to your [partner profile](https://partner.microsoft.com/pcv/accountsettings/connectedpartnerprofile) > Identifiers blade > Microsoft Cloud Partners Program Tab
285+
2. Use the Partner ID with type PartnerGlobal in the request
286+
234287
### MSANotSupported
235288

236289
This feature isn't supported for Microsoft consumer accounts. Only applications registered in Azure AD by an Azure AD user are supported.
@@ -243,18 +296,23 @@ Occurs when multi-factor authentication (MFA) hasn't been enabled and performed
243296

244297
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 multi-factor authentication to proceed."
245298

299+
**Remediation Steps**
300+
1. Ensure [multi-factor authentication](../fundamentals/concept-fundamentals-mfa-get-started.md) is enabled and **required** for the user you're signing in with and for this scenario
301+
2. Retry Publisher Verification
302+
246303
### UserUnableToAddPublisher
247304

248305
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’, an error, “You're unable to add a verified publisher to this application. Contact your administrator for assistance” will be returned. Please investigate the user risk and take the appropriate steps to remediate the risk (guidance below):
249306

307+
**Remediation Steps**
250308
> [Investigate risk](../identity-protection/howto-identity-protection-investigate-risk.md#risky-users)
251-
309+
>
252310
> [Remediate risk/unblock users](../identity-protection/howto-identity-protection-remediate-unblock.md)
253-
311+
>
254312
> [Self-remediation guidance](../identity-protection/howto-identity-protection-remediate-unblock.md)
255-
313+
>
256314
> 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.
257-
315+
>
258316
> [!NOTE]
259317
> Please give some time after remediation for the risk state to update, and then try again.
260318
@@ -275,4 +333,4 @@ If you've reviewed all of the previous information and are still receiving an er
275333
- TenantId where app is registered
276334
- MPN ID
277335
- REST request being made
278-
- Error code and message being returned
336+
- Error code and message being returned

0 commit comments

Comments
 (0)