Skip to content

website/docs: entra id provider: add custom email domain info#20444

Merged
dewi-tik merged 6 commits intomainfrom
website/docs--update-entra-provider
Mar 2, 2026
Merged

website/docs: entra id provider: add custom email domain info#20444
dewi-tik merged 6 commits intomainfrom
website/docs--update-entra-provider

Conversation

@dewi-tik
Copy link
Contributor

Details

Depends on this PR being merged: #20441

Adds information about using custom email domains in entra.


Checklist

If applicable

  • The documentation has been updated
  • The documentation has been formatted (make docs)

@dewi-tik dewi-tik self-assigned this Feb 20, 2026
@dewi-tik dewi-tik added the area:docs Features or issues related to Docusaurus label Feb 20, 2026
@netlify
Copy link

netlify bot commented Feb 20, 2026

Deploy Preview for authentik-integrations ready!

Name Link
🔨 Latest commit 0fe5287
🔍 Latest deploy log https://app.netlify.com/projects/authentik-integrations/deploys/69a589a23ba63c0008ae4ff3
😎 Deploy Preview https://deploy-preview-20444--authentik-integrations.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify
Copy link

netlify bot commented Feb 20, 2026

Deploy Preview for authentik-storybook ready!

Name Link
🔨 Latest commit 0fe5287
🔍 Latest deploy log https://app.netlify.com/projects/authentik-storybook/deploys/69a589a2c3ea6f00081a8fed
😎 Deploy Preview https://deploy-preview-20444--authentik-storybook.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify
Copy link

netlify bot commented Feb 20, 2026

Deploy Preview for authentik-docs ready!

Name Link
🔨 Latest commit 0fe5287
🔍 Latest deploy log https://app.netlify.com/projects/authentik-docs/deploys/69a589a2dac9c000082ee023
😎 Deploy Preview https://deploy-preview-20444--authentik-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@codecov
Copy link

codecov bot commented Feb 20, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.38%. Comparing base (f6076d1) to head (0fe5287).
⚠️ Report is 1 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@           Coverage Diff           @@
##             main   #20444   +/-   ##
=======================================
  Coverage   93.38%   93.38%           
=======================================
  Files         981      981           
  Lines       55392    55392           
=======================================
+ Hits        51727    51728    +1     
+ Misses       3665     3664    -1     
Flag Coverage Δ
conformance 37.69% <ø> (+<0.01%) ⬆️
e2e 43.33% <ø> (+<0.01%) ⬆️
integration 22.47% <ø> (+<0.01%) ⬆️
unit 91.53% <ø> (+<0.01%) ⬆️
unit-migrate 91.62% <ø> (+<0.01%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@dewi-tik dewi-tik marked this pull request as ready for review February 20, 2026 17:09
@dewi-tik dewi-tik requested a review from a team as a code owner February 20, 2026 17:09
@dewi-tik dewi-tik added the backport/version-2026.2 Add this label to PRs to backport changes to version-2026.2 label Feb 20, 2026

### Email-verified-users

Alternatively, if you need to provision users with email domains that you don't control, you can provision users as "email-verified-users" in Entra ID.
Copy link
Member

Choose a reason for hiding this comment

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

as what? what's that and how does it work

Copy link
Member

Choose a reason for hiding this comment

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

nvm it's below, but feels confusing

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Any suggestions for improvements?

3. Select **Microsoft Entra Provider Mapping** as the property mapping type and click **Next**.
4. Provide a **Name** for the property mapping and set the following **Expression**:

```python showLineNumbers
Copy link
Member

Choose a reason for hiding this comment

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

have you validated this mapping by jens or other?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Tested and working against Entra ID. Have asked Jens to check the mapping.

@github-project-automation github-project-automation bot moved this from Todo to In Progress in authentik Core Feb 20, 2026
Co-authored-by: Dominic R <dominic@sdko.org>
Signed-off-by: Dewi Roberts <dewi@goauthentik.io>
@github-actions
Copy link
Contributor

github-actions bot commented Feb 20, 2026

authentik PR Installation instructions

Instructions for docker-compose

Add the following block to your .env file:

AUTHENTIK_IMAGE=ghcr.io/goauthentik/dev-server
AUTHENTIK_TAG=gh-0fe52876b1834fb5b10d7c45404b40c111aab436
AUTHENTIK_OUTPOSTS__CONTAINER_IMAGE_BASE=ghcr.io/goauthentik/dev-%(type)s:gh-%(build_hash)s

Afterwards, run the upgrade commands from the latest release notes.

Instructions for Kubernetes

Add the following block to your values.yml file:

authentik:
    outposts:
        container_image_base: ghcr.io/goauthentik/dev-%(type)s:gh-%(build_hash)s
global:
    image:
        repository: ghcr.io/goauthentik/dev-server
        tag: gh-0fe52876b1834fb5b10d7c45404b40c111aab436

Afterwards, run the upgrade commands from the latest release notes.

@dewi-tik dewi-tik requested review from BeryJu and dominic-r February 24, 2026 09:36
@dewi-tik dewi-tik enabled auto-merge (squash) March 2, 2026 12:59
@dewi-tik dewi-tik moved this from In Progress to In review in authentik Core Mar 2, 2026
@dewi-tik dewi-tik merged commit cd53bc1 into main Mar 2, 2026
102 checks passed
@dewi-tik dewi-tik deleted the website/docs--update-entra-provider branch March 2, 2026 13:29
@github-project-automation github-project-automation bot moved this from In review to Done in authentik Core Mar 2, 2026
authentik-automation bot pushed a commit that referenced this pull request Mar 2, 2026
* WIP

* WIP

* Apply suggestions from code review

Co-authored-by: Dominic R <dominic@sdko.org>
Signed-off-by: Dewi Roberts <dewi@goauthentik.io>

---------

Signed-off-by: Dewi Roberts <dewi@goauthentik.io>
Co-authored-by: Dominic R <dominic@sdko.org>
@authentik-automation
Copy link
Contributor

🍒 Cherry-pick to version-2026.2 created: #20660

dewi-tik added a commit that referenced this pull request Mar 2, 2026
…-pick #20444 to version-2026.2) (#20660)

website/docs: entra id provider: add custom email domain info (#20444)

* WIP

* WIP

* Apply suggestions from code review




---------

Signed-off-by: Dewi Roberts <dewi@goauthentik.io>
Co-authored-by: Dewi Roberts <dewi@goauthentik.io>
Co-authored-by: Dominic R <dominic@sdko.org>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:docs Features or issues related to Docusaurus backport/version-2026.2 Add this label to PRs to backport changes to version-2026.2

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

3 participants