Skip to content

Clarify preferredTokenSigningKeyThumbprint property - #10020

Open
jsoveral wants to merge 1 commit into
microsoftgraph:mainfrom
jsoveral:patch-2
Open

Clarify preferredTokenSigningKeyThumbprint property#10020
jsoveral wants to merge 1 commit into
microsoftgraph:mainfrom
jsoveral:patch-2

Conversation

@jsoveral

Copy link
Copy Markdown
Contributor

Updated the description of the preferredTokenSigningKeyThumbprint property to clarify its purpose and usage.

Important

Use the AI-powered workflow for Graph onboarding to author and self-review schema-related changes. See https://aka.ms/msgraphcdk for more information.

Required for API changes:

  • [] Link to API.md file: ADD LINK HERE
  • [] Link to PR for public-facing schema changes (schema-Prod-beta/v1.0.csdl): ADD LINK HERE

Add other supporting information, such as a description of the PR changes:

ADD INFORMATION HERE


Important

The following guidance is for Microsoft employees only. Community contributors can ignore this message; our content team will manage the status.

After you've created your PR, expand this section for tips and additional instructions.
  • do not merge is the default PR status and is automatically added to all open PRs that don't have the ready to merge label.
  • Add the ready for content review label to start a review. Only PRs that have met the minimum requirements for content review and have this label are reviewed.
  • If your content reviewer requests changes, review the feedback and address accordingly as soon as possible to keep your pull request moving forward. After you address the feedback, remove the changes requested label, add the review feedback addressed label, and select the Re-request review icon next to the content reviewer's alias. If you can't add labels, add a comment with #feedback-addressed to the pull request.
  • After the content review is complete, your reviewer will add the content review complete label. When the updates in this PR are ready for external customers to use, replace the do not merge label with ready to merge and the PR will be merged within 24 working hours.
  • Pull requests that are inactive for more than 6 weeks will be automatically closed. Before that, you receive reminders at 2 weeks, 4 weeks, and 6 weeks. If you still need the PR, you can reopen or recreate the request.

For more information, see the Content review process summary.

Updated the description of the preferredTokenSigningKeyThumbprint property to clarify its purpose and usage.
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 3411d4b:

⚠️ Validation status: warnings

File Status Preview URL Details
api-reference/beta/api/b2cidentityuserflow-list-languages.md ⚠️Warning Details
api-reference/beta/api/b2cidentityuserflow-list-userflowidentityproviders.md ⚠️Warning Details
api-reference/beta/api/b2xidentityuserflow-list-userflowidentityproviders.md ⚠️Warning Details
api-reference/beta/api/cloudlicensing-admincloudlicensing-list-assignments.md ⚠️Warning Details
api-reference/beta/api/cloudlicensing-assignment-get-assignedto.md ⚠️Warning Details
api-reference/beta/api/cloudlicensing-assignmenterror-get-assignedto.md ⚠️Warning Details
api-reference/beta/api/cloudlicensing-assignmenterror-get-usageright.md ⚠️Warning Details
api-reference/beta/api/cloudlicensing-usageright-get.md ⚠️Warning Details
api-reference/beta/api/cloudpcpool-list-assignments.md ⚠️Warning Details
api-reference/beta/api/connector-post-memberof.md ⚠️Warning Details
api-reference/beta/api/connectorgroup-post-members.md ⚠️Warning Details
api-reference/beta/api/driveitem-lock.md ⚠️Warning Details
api-reference/beta/api/driveitem-releaselock.md ⚠️Warning Details
api-reference/beta/api/educationroot-list-users.md ⚠️Warning Details
api-reference/beta/api/healthmonitoring-healthmonitoringroot-list-alertconfigurations.md ⚠️Warning Details
api-reference/beta/api/healthmonitoring-healthmonitoringroot-list-alerts.md ⚠️Warning Details
api-reference/beta/api/identitygovernance-run-list-subjectprocessingresults.md ⚠️Warning Details
api-reference/beta/api/identitygovernance-taskreport-list-subjectprocessingresults.md ⚠️Warning Details
api-reference/beta/api/intune-androidforwork-androiddeviceownerenrollmentprofile-clearenrollmenttimedevicemembershiptarget.md ⚠️Warning Details
api-reference/beta/api/intune-androidforwork-androiddeviceownerenrollmentprofile-createtoken.md ⚠️Warning Details
api-reference/beta/api/intune-androidforwork-androiddeviceownerenrollmentprofile-retrieveenrollmenttimedevicemembershiptarget.md ⚠️Warning Details
api-reference/beta/api/intune-androidforwork-androiddeviceownerenrollmentprofile-revoketoken.md ⚠️Warning Details
api-reference/beta/api/intune-androidforwork-androiddeviceownerenrollmentprofile-setenrollmenttimedevicemembershiptarget.md ⚠️Warning Details
api-reference/beta/api/intune-androidforwork-androidforworkenrollmentprofile-createtoken.md ⚠️Warning Details
api-reference/beta/api/intune-androidforwork-androidforworkenrollmentprofile-revoketoken.md ⚠️Warning Details

This comment lists only the first 25 files in the pull request.

api-reference/beta/api/b2cidentityuserflow-list-languages.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'List languages - Microsoft Graph beta' is duplicated in: 'beta/api/b2cidentityuserflow-list-languages.md(2,8), beta/api/profile-list-languages.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'List languages' is duplicated with other articles: 'beta/api/b2cidentityuserflow-list-languages.md(11,1), beta/api/profile-list-languages.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/b2cidentityuserflow-list-userflowidentityproviders.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'List a userflowidentityproviders - Microsoft Graph beta' is duplicated in: 'beta/api/b2cidentityuserflow-list-userflowidentityproviders.md(2,8), beta/api/b2xidentityuserflow-list-userflowidentityproviders.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'List a userflowidentityproviders' is duplicated with other articles: 'beta/api/b2cidentityuserflow-list-userflowidentityproviders.md(11,1), beta/api/b2xidentityuserflow-list-userflowidentityproviders.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/b2xidentityuserflow-list-userflowidentityproviders.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'List a userflowidentityproviders - Microsoft Graph beta' is duplicated in: 'beta/api/b2cidentityuserflow-list-userflowidentityproviders.md(2,8), beta/api/b2xidentityuserflow-list-userflowidentityproviders.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'List a userflowidentityproviders' is duplicated with other articles: 'beta/api/b2cidentityuserflow-list-userflowidentityproviders.md(11,1), beta/api/b2xidentityuserflow-list-userflowidentityproviders.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/cloudlicensing-admincloudlicensing-list-assignments.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'List assignments - Microsoft Graph beta' is duplicated in: 'beta/api/cloudlicensing-admincloudlicensing-list-assignments.md(2,8), beta/api/cloudpcpool-list-assignments.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'List assignments' is duplicated with other articles: 'beta/api/cloudlicensing-admincloudlicensing-list-assignments.md(11,1), beta/api/cloudpcpool-list-assignments.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/cloudlicensing-assignment-get-assignedto.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Get assignedTo - Microsoft Graph beta' is duplicated in: 'beta/api/cloudlicensing-assignment-get-assignedto.md(2,8), beta/api/cloudlicensing-assignmenterror-get-assignedto.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'Get assignedTo' is duplicated with other articles: 'beta/api/cloudlicensing-assignment-get-assignedto.md(11,1), beta/api/cloudlicensing-assignmenterror-get-assignedto.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/cloudlicensing-assignmenterror-get-assignedto.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Get assignedTo - Microsoft Graph beta' is duplicated in: 'beta/api/cloudlicensing-assignment-get-assignedto.md(2,8), beta/api/cloudlicensing-assignmenterror-get-assignedto.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'Get assignedTo' is duplicated with other articles: 'beta/api/cloudlicensing-assignment-get-assignedto.md(11,1), beta/api/cloudlicensing-assignmenterror-get-assignedto.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/cloudlicensing-assignmenterror-get-usageright.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Get usageRight - Microsoft Graph beta' is duplicated in: 'beta/api/cloudlicensing-assignmenterror-get-usageright.md(2,8), beta/api/cloudlicensing-usageright-get.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'Get usageRight' is duplicated with other articles: 'beta/api/cloudlicensing-assignmenterror-get-usageright.md(11,1), beta/api/cloudlicensing-usageright-get.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/cloudlicensing-usageright-get.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'Get usageRight - Microsoft Graph beta' is duplicated in: 'beta/api/cloudlicensing-assignmenterror-get-usageright.md(2,8), beta/api/cloudlicensing-usageright-get.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'Get usageRight' is duplicated with other articles: 'beta/api/cloudlicensing-assignmenterror-get-usageright.md(11,1), beta/api/cloudlicensing-usageright-get.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/cloudpcpool-list-assignments.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'List assignments - Microsoft Graph beta' is duplicated in: 'beta/api/cloudlicensing-admincloudlicensing-list-assignments.md(2,8), beta/api/cloudpcpool-list-assignments.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'List assignments' is duplicated with other articles: 'beta/api/cloudlicensing-admincloudlicensing-list-assignments.md(11,1), beta/api/cloudpcpool-list-assignments.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/connector-post-memberof.md

  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'Add connector to connectorGroup' is duplicated with other articles: 'beta/api/connector-post-memberof.md(11,1), beta/api/connectorgroup-post-members.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/connectorgroup-post-members.md

  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'Add connector to connectorGroup' is duplicated with other articles: 'beta/api/connector-post-memberof.md(11,1), beta/api/connectorgroup-post-members.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/driveitem-lock.md

  • Line 4, Column 9: [Warning: author-not-found - See documentation] Invalid value for author: 'adwaitkumar' is not a valid GitHub ID.

api-reference/beta/api/driveitem-releaselock.md

  • Line 4, Column 9: [Warning: author-not-found - See documentation] Invalid value for author: 'adwaitkumar' is not a valid GitHub ID.

api-reference/beta/api/educationroot-list-users.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'List users - Microsoft Graph beta' is duplicated in: 'beta/api/educationroot-list-users.md(2,8), beta/api/intune-shared-user-list.md(2,8), beta/api/security-discoveredcloudappdetail-list-users.md(2,8)'. Titles must be unique within a docset.
  • Line 11, Column 1: [Warning: duplicate-h1s - See documentation] H1 'List users' is duplicated with other articles: 'beta/api/educationroot-list-users.md(11,1), beta/api/intune-shared-user-list.md(11,1), beta/api/security-discoveredcloudappdetail-list-users.md(11,1)'. First level headings must be unique within a docset.

api-reference/beta/api/healthmonitoring-healthmonitoringroot-list-alertconfigurations.md

  • Line 2, Column 8: [Warning: duplicate-titles - See documentation] Title 'List alertConfigurations - Microsoft Graph beta' is duplicated in: 'beta/api/healthmonitoring-healthmonitoringroot-list-alertconfigurations.md(2,8), beta/api/rolemanagementalert-list-alertconfigurations.md(2,8)'. Titles must be unique within a docset.

This comment lists only the first 25 errors (including error/warning/suggestion) in the pull request.
For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

|preferredSingleSignOnMode|string|Specifies the single sign-on mode configured for this application. Microsoft Entra ID uses the preferred single sign-on mode to launch the application from Microsoft 365 or the Microsoft Entra My Apps. The supported values are password, saml, external, and oidc.|
|preferredTokenSigningKeyEndDateTime|DateTimeOffset|Specifies the expiration date of the keyCredential used for token signing, marked by **preferredTokenSigningKeyThumbprint**.|
|preferredTokenSigningKeyThumbprint|String|Reserved for internal use only. Don't write or otherwise rely on this property. May be removed in future versions. |
|preferredTokenSigningKeyThumbprint|String|Thumbprint of the keyCredentials certificate used to sign SAML tokens for this service principal; set with useCustomTokenSigningKey = true to activate or roll over the SAML SSO signing certificate.|

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hello jsoveral, for clarity and alignment with the Microsoft Graph docs standards. Please update the description. Suggested revision:

Suggested change
|preferredTokenSigningKeyThumbprint|String|Thumbprint of the keyCredentials certificate used to sign SAML tokens for this service principal; set with useCustomTokenSigningKey = true to activate or roll over the SAML SSO signing certificate.|
|preferredTokenSigningKeyThumbprint|String|The thumbprint of the **keyCredentials** certificate used to sign SAML tokens for this service principal. To activate or roll over the SAML sign-on (SSO) signing certificate, set this property when **useCustomTokenSigningKey** is set to `true`.|

@v-regandowner Regan Downer (v-regandowner) added the aq-pr-triaged PR has been processed by the Aquent PR review team label Aug 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

aq-pr-triaged PR has been processed by the Aquent PR review team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants