You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.
Copy file name to clipboardExpand all lines: articles/active-directory/develop/troubleshoot-publisher-verification.md
+67-13Lines changed: 67 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -44,11 +44,7 @@ Below are some common issues that may occur during the process.
44
44
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.
45
45
46
46
-**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).
52
48
53
49
-**When I sign into the Azure AD portal, I do not see any apps registered. Why?**
54
50
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.
150
146
151
147
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.
152
148
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
+
153
156
### MPNGlobalAccountNotFound
154
157
155
158
The MPN ID you provided (`MPNID`) isn't valid. Provide a valid MPN ID and try again.
156
159
157
160
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.
158
161
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
+
159
166
### MPNAccountInvalid
160
167
161
168
The MPN ID you provided (`MPNID`) isn't valid. Provide a valid MPN ID and try again.
162
169
163
170
Most commonly caused by the wrong MPN ID being provided.
164
171
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
+
165
176
### MPNAccountNotVetted
166
177
167
178
The MPN ID (`MPNID`) you provided hasn't completed the vetting process. Complete this process in Partner Center and try again.
168
179
169
180
Most commonly caused by when the MPN account hasn't completed the [verification](/partner-center/verification-responses) process.
170
181
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
+
171
186
### NoPublisherIdOnAssociatedMPNAccount
172
187
173
188
The MPN ID you provided (`MPNID`) isn't valid. Provide a valid MPN ID and try again.
174
189
175
190
Most commonly caused by the wrong MPN ID being provided.
176
191
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
+
177
196
### MPNIdDoesNotMatchAssociatedMPNAccount
178
197
179
198
The MPN ID you provided (`MPNID`) isn't valid. Provide a valid MPN ID and try again.
180
199
181
200
Most commonly caused by the wrong MPN ID being provided.
182
201
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
+
183
206
### ApplicationNotFound
184
207
185
208
The target application (`AppId`) can’t be found. Provide a valid application ID and try again.
186
209
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
+
188
217
189
218
### ApplicationObjectisInvalid
190
219
191
220
The target application's object ID is invalid. Please provide a valid ID and try again.
192
221
193
222
Most commonly caused when the verification is being performed via Graph API, and the ID of the application provided does not exist.
194
223
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
197
228
198
229
199
-
200
230
### B2CTenantNotAllowed
201
231
202
232
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
211
241
212
242
Occurs when a [Publisher Domain](howto-configure-publisher-domain.md) isn't configured on the app.
213
243
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
+
214
247
### PublisherDomainMismatch
215
248
216
249
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
219
252
220
253
See [requirements](publisher-verification-overview.md) for a list of allowed domain or sub-domain matches.
221
254
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
+
222
263
### NotAuthorizedToVerifyPublisher
223
264
224
265
You aren't authorized to set the verified publisher property on application (<`AppId`).
225
266
226
267
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.
227
268
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
+
228
276
### MPNIdWasNotProvided
229
277
230
278
The MPN ID wasn't provided in the request body or the request content type wasn't "application/json".
231
279
232
280
Most commonly caused when the verification is being performed via Graph API, and the MPN ID wasn’t provided in the request.
233
281
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
+
234
286
### MSANotSupported
235
287
236
288
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
243
295
244
296
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."
245
297
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
+
246
302
### UserUnableToAddPublisher
247
303
248
304
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):
> 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
311
258
312
> [!NOTE]
@@ -275,4 +329,4 @@ If you've reviewed all of the previous information and are still receiving an er
0 commit comments