Skip to content

docs(windows): add smartscreen knowlege base#2510

Open
rc-swag wants to merge 1 commit into
masterfrom
docs/kb-smartscreen-notification
Open

docs(windows): add smartscreen knowlege base#2510
rc-swag wants to merge 1 commit into
masterfrom
docs/kb-smartscreen-notification

Conversation

@rc-swag
Copy link
Copy Markdown
Contributor

@rc-swag rc-swag commented May 13, 2026

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

Add explanation and installtion steps for the smartscreen notification
that has started to appear due to Microsoft trusted application polices.

fixes: #2509
@keymanapp-test-bot
Copy link
Copy Markdown

keymanapp-test-bot Bot commented May 13, 2026

User Test Results

Test specification and instructions

User tests are not required

@keymanapp-test-bot keymanapp-test-bot Bot added this to the A19S29 milestone May 13, 2026
@github-actions github-actions Bot added the docs label May 13, 2026
@github-project-automation github-project-automation Bot moved this to Todo in Keyman May 13, 2026
@rc-swag rc-swag requested a review from mcdurdin May 13, 2026 04:55
@rc-swag rc-swag self-assigned this May 13, 2026
Comment thread knowledge-base/kb0119.md
# 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.
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.

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.

Comment thread knowledge-base/kb0119.md
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.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

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!

@ermshiperete ermshiperete changed the title docs: add smartscreen knowlege base docs(windows): add smartscreen knowlege base May 13, 2026
Comment thread knowledge-base/kb0119.md
<img src="./assets/kb0119/smartscreen_keyman.png" width="75%" alt="SmartScreen Notification More Info "/>


**What has changed**
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.

Suggested change
**What has changed**
### What has changed

Comment thread knowledge-base/kb0119.md

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

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

docs(windows): smartscreen knowledge base explaining notification and installation.

5 participants