Skip to content

Commit 42ba2ce

Browse files
authored
Update troubleshoot-publisher-verification.md
Adding remediation steps for each given error - adding links to relevant sections of the doc when available. We've been receiving customer reports of developers finding remediation steps unclear for errors, so adding specific steps for each error is intended to reduce the friction for this process.
1 parent f59b642 commit 42ba2ce

File tree

1 file changed

+67
-13
lines changed

1 file changed

+67
-13
lines changed

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

Lines changed: 67 additions & 13 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+
See the remediation guidance [here](#mpnaccountnotfoundornoaccess).
5248

5349
- **When I sign into the Azure AD 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,87 @@ 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+
- The MPN ID is correct.
152+
- There are no errors or “pending actions” shown, and the verification status under Legal business profile and Partner info both say “authorized” or “success”.
153+
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.
154+
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).
155+
153156
### MPNGlobalAccountNotFound
154157

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

157160
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.
158161

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

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

163170
Most commonly caused by the wrong MPN ID being provided.
164171

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

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

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

182+
**Remediation Steps**
183+
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”.
184+
2. If not, view pending action items in Partner Center and troubleshoot with [here](https://learn.microsoft.com/en-us/partner-center/verification-responses)
185+
171186
### NoPublisherIdOnAssociatedMPNAccount
172187

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

175190
Most commonly caused by the wrong MPN ID being provided.
176191

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

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

181200
Most commonly caused by the wrong MPN ID being provided.
182201

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

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

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.
210+
Most commonly caused when verification is being performed via Graph API, and the ID of the application provided is incorrect.
211+
212+
**Remediation Steps**
213+
1. The Object ID of the application must be provided, not the AppId/ClientId. See "id" on the list of application properties [here](https://learn.microsoft.com/en-us/graph/api/resources/application?view=graph-rest-1.0)
214+
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
215+
3. Find your app's registration to view the Object ID
216+
188217

189218
### ApplicationObjectisInvalid
190219

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

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

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).
224+
**Remediation Steps**
225+
1. The Object ID of the application must be provided, not the AppId/ClientId. See "id" on the list of application properties [here](https://learn.microsoft.com/en-us/graph/api/resources/application?view=graph-rest-1.0)
226+
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
227+
3. Find your app's registration to view the Object ID
197228

198229

199-
200230
### B2CTenantNotAllowed
201231

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

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

244+
**Remediation Steps**
245+
1. Follow the directions [here](https://learn.microsoft.com/en-us/azure/active-directory/develop/howto-configure-publisher-domain#set-a-publisher-domain-in-the-azure-portal) to set a Publisher Domain
246+
214247
### PublisherDomainMismatch
215248

216249
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 +252,37 @@ Occurs when neither the app's [Publisher Domain](howto-configure-publisher-domai
219252

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

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

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

226267
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.
227268

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

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

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

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

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

244296
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."
245297

298+
**Remediation Steps**
299+
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
300+
2. Retry Publisher Verification
301+
246302
### UserUnableToAddPublisher
247303

248304
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):
249305

306+
**Remediation Steps**
250307
> [Investigate risk](../identity-protection/howto-identity-protection-investigate-risk.md#risky-users)
251-
252308
> [Remediate risk/unblock users](../identity-protection/howto-identity-protection-remediate-unblock.md)
253-
254309
> [Self-remediation guidance](../identity-protection/howto-identity-protection-remediate-unblock.md)
255-
256310
> 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.
257311
258312
> [!NOTE]
@@ -275,4 +329,4 @@ If you've reviewed all of the previous information and are still receiving an er
275329
- TenantId where app is registered
276330
- MPN ID
277331
- REST request being made
278-
- Error code and message being returned
332+
- Error code and message being returned

0 commit comments

Comments
 (0)