docs(windows): add smartscreen knowlege base#2510
Open
rc-swag wants to merge 1 commit into
Open
Conversation
Add explanation and installtion steps for the smartscreen notification that has started to appear due to Microsoft trusted application polices. fixes: #2509
User Test ResultsTest specification and instructions User tests are not required |
darcywong00
reviewed
May 13, 2026
| # Microsoft Defender SmartScreen | ||
|
|
||
| ## Summary | ||
| Due to changes in how certificate signing and trusted applications are handled, you *may* see the following SmartScreen notification when installing Keyman. |
Contributor
There was a problem hiding this comment.
just minor tweaks:
Suggested change
| Due to changes in how certificate signing and trusted applications are handled, you *may* see the following SmartScreen notification when installing Keyman. | |
| Due to changes in how Microsoft handles certificate signing and trusted applications, you *may* see the following SmartScreen notification when installing Keyman for Windows or Keyman Developer. |
mcdurdin
reviewed
May 13, 2026
| Previously, applications signed by Azure Artifact Signing (formerly Trusted Signing) meant that there was no SmartScreen prompts during installation. Microsoft Defender SmartScreen now relies also on application reputation, which is built over time based on factors determined by Microsoft. | ||
|
|
||
| As a result, SmartScreen prompts may appear until the Keyman installer establishes sufficient reputation. | ||
|
|
Member
There was a problem hiding this comment.
Perhaps add another line:
Suggested change
| ## How to know if the downloaded file is trustworthy | |
| If you are presented with a SmartScreen warning, check the publisher in the "More Info" screen. If the publisher field shows the name "Summer Institute of Linguistics, Inc.", then that confirms that we built the installer and it can be trusted. See the image above for a representative example. | |
| If any other name is shown in the Publisher field, do not run the installer, and please [contact us](/contact) for further assistance! |
| <img src="./assets/kb0119/smartscreen_keyman.png" width="75%" alt="SmartScreen Notification More Info "/> | ||
|
|
||
|
|
||
| **What has changed** |
Contributor
There was a problem hiding this comment.
Suggested change
| **What has changed** | |
| ### What has changed |
|
|
||
| Previously, applications signed by Azure Artifact Signing (formerly Trusted Signing) meant that there was no SmartScreen prompts during installation. Microsoft Defender SmartScreen now relies also on application reputation, which is built over time based on factors determined by Microsoft. | ||
|
|
||
| As a result, SmartScreen prompts may appear until the Keyman installer establishes sufficient reputation. |
Contributor
There was a problem hiding this comment.
Suggested change
| As a result, SmartScreen prompts may appear until the Keyman installer establishes sufficient reputation. | |
| As a result, SmartScreen prompts may appear until a new version of the Keyman installer establishes sufficient reputation. |
This might make it clearer that this needs to happen for each new version.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Add explanation and installtion steps for the smartscreen notification that has started to appear due to Microsoft trusted application polices.
fixes: #2509
Test-bot: skip