BeyondERP.Newsletter
Menu

Setup step on the Certificate profiles page · System administration

Set up Certificate profiles

Use this page to give each certificate one ID that works across companies, and to set per legal entity which local or Key Vault certificates the Commerce channels can use.

Used by
Retail service, Information technology manager
Business process
Administer system features
Menu item
RetailUserDefinedCertificateProfile
Main table
RetailUserDefinedCertificateProfile
Data entity
None for this page's own settings
Setup steps
1 on this page
Show what matters for
SETUP GUIDEHow to set it up8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA setup page where you create certificate profiles that name a default certificate and set the order in which certificates are searched.
What you do hereUse this page to give each certificate one ID that works across companies, and to set per legal entity which local or Key Vault certificates the Commerce channels can use.
ExampleFor example, a store's point of sale can fall back to a local certificate while it runs offline and can't reach Key Vault.
Certificate profiles page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Setup steps on this page

Set up Certificate profiles

Use this page to give each certificate one ID that works across companies, and to set per legal entity which local or Key Vault certificates the Commerce channels can use.

Steps from Microsoft

  1. Go to System administration > Setup > Certificate profiles.
  2. Select New.
  3. Enter values in the Certificate profile, Name and Description fields.
  4. On the Legal entities FastTab, select Add and choose the legal entity that should use the profile.
  5. Repeat for each other legal entity that needs the profile.
  6. Select Settings to open the Certificate profile settings page.
  7. Add a line for each certificate that can be used, in priority order.
  8. On each line, set Location type, then either Key Vault certificate or Thumbprint (and optionally Store name and Store location).

Source: Microsoft Learn

Fields on the page

FieldWhat it meansTable column
Certificate profileThe unique ID of the certificate across all companies and Commerce components.Microsoft Learn ProfileId
PrioritySet automatically; 1 is tried first, and Move up or Move down changes the order.Microsoft Learn
Location typeWhere the certificate is stored: Local certificate or Key Vault.Microsoft Learn
Key Vault certificateThe Key Vault certificate secret to use; required when Location type is Key Vault.Microsoft Learn
Store nameOptional default store name used to search for a local certificate.Microsoft Learn
ThumbprintThe thumbprint of a local certificate; required when Location type is Local certificate.Microsoft Learn

Common errors and fixes

MessageWhat to do
A store that is offline can't sign or read data with the certificateAdd a Local certificate line (Thumbprint, Store name, Store location) after the Key Vault line, and give the user who runs the app, for example Store Commerce in offline mode, read access to the local certificate's private key. Microsoft Learn
A changed certificate line isn't used straight awayCertificate search results are cached (one hour by default), so a change can take up to the cache time to apply. Microsoft Learn

Test checklist

  1. Set Use advanced certificate store to Yes on System parameters and turn on the feature.
  2. Create a certificate profile, add the legal entity and open Settings.
  3. Add a Key Vault line at priority 1 and a Local certificate line with its Thumbprint at priority 2.
  4. Run a store terminal offline and check that the local certificate is used.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Certificate profilesOne certificate profile per certificate, with a Key Vault line at priority 1 and a Local certificate line as the fallbackWhen Key Vault can't be reached, the certificate isn't found there or the POS is offline, the Commerce runtime moves to the next line by priority, so a local certificate keeps stores working.Which certificate locations should a profile search, and in what order?Not giving the user who runs the app (for example Store Commerce in offline mode) read access to the local certificate's private key, so the local fallback fails.Test: Certificate profile falls back to the local certificate

Feature management and licence

Feature to turn onUser-defined certificate profiles for retail stores (Must be on)
Licence or add-inOn this system the page opens for Information technology manager and Retail service. Turn on the feature and set Use advanced certificate store to Yes on System parameters before you create profiles.

Microsoft Learn

Solution architect

5Design impact

Shared or per companySet per legal entity: a profile has one ID that works across companies and Commerce components, and each legal entity that may use it is added on the Legal entities FastTab with its own certificate lines in Settings. Microsoft Learn
Can it be undoneReversible: Lines can be added and reordered at any time; a new certificate version can be rolled out gradually by adding it as a higher-priority line.
If you change it laterTo roll out a new certificate version store by store, add it as a higher-priority line; stores that don't have it yet keep using the previous version. Microsoft Learn
Technical architect

6Technical

Menu itemRetailUserDefinedCertificateProfile Checked in Dynamics 365
FormRetailUserDefinedCertificateProfile Checked in Dynamics 365
TableRetailUserDefinedCertificateProfileShown as “Certificate profiles” in Record infoChecked in Dynamics 365
Data entitiesRetailUserDefinedCertificateProfileSettingsEntityCertificate profile settings (only the certificate lines on the Certificate profile settings page; the profiles and their legal entities are entered on this page by hand)
Who can open itPrivilegesMaintain Certificate profiles RetailUserDefinedCertificateProfileMaintainDutiesMaintain Retail security parameters RetailSecurityParametersMaintainMaintain system settings SysServerSettingsMaintain
2 security rolesRetail service RetailServiceInformation technology manager SysServerITManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itInformation technology manager SysServerITManagerRetail service RetailServiceGive people one of these roles. On this system, 2 roles can open this page.Checked in Dynamics 365
Actions on the pageOptions: Personalize, Page options, ShareChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=RetailUserDefinedCertificateProfile
Data migrationRetailUserDefinedCertificateProfileSettingsEntity (Certificate profile settings): shared; loads the certificate lines of existing profiles.Load order: Certificate profile settings isn't in Microsoft's default configuration templates. Create each certificate profile and add its legal entities by hand first, then load the settings lines.Load first: Certificate profiles and their legal entities, entered by hand, Key Vault parameters (for Key Vault lines)Checked in Dynamics 365
Everyone

8Sources

To cite this step: SA-SETUP-160, Set up Certificate profiles. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/SA-SETUP-160