Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs: azure update #1183

Merged
merged 13 commits into from
Jan 24, 2024
Merged

Docs: azure update #1183

merged 13 commits into from
Jan 24, 2024

Conversation

ZPain8464
Copy link
Contributor

@ZPain8464 ZPain8464 commented Jan 19, 2024

This PR updates the Azure AD idp guide. The update includes:

  • Changing all instances of Azure AD to Entra ID (where appropriate. You still user the Azure portal to configure the application.)
  • Changing Office 365 to Microsoft 365
  • Updating screenshots and deleting the /azure/ image directory and replacing it with a new entra directory

A few things I need team input on:

  • Should we update the path from /identity-providers/azure to /identity-providers/entra? If so, we'd need to add redirects. I'm for keeping azure, just because redirects become difficult to maintain over time. This page is also indexed as azure, and updating the path could have unforeseen consequences with search engines.
  • Should we move the Troubleshooting section under the Directory Sync tab to the troubleshooting page?

Fixes #1144

@ZPain8464 ZPain8464 requested a review from a team as a code owner January 19, 2024 23:27
@ZPain8464 ZPain8464 requested review from cmo-pomerium and removed request for a team January 19, 2024 23:27
Copy link

netlify bot commented Jan 19, 2024

Deploy Preview for pomerium-docs ready!

Name Link
🔨 Latest commit 4b64a23
🔍 Latest deploy log https://app.netlify.com/sites/pomerium-docs/deploys/65b144ad45fc8800081c4dc3
😎 Deploy Preview https://deploy-preview-1183--pomerium-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 site configuration.

content/docs/identity-providers/azure.mdx Outdated Show resolved Hide resolved
content/docs/identity-providers/azure.mdx Outdated Show resolved Hide resolved
content/docs/identity-providers/azure.mdx Outdated Show resolved Hide resolved
pagination_next: null
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

This page will help you configure Pomerium to use your Azure Active Directory as an IdP. It assumes you have already [installed Pomerium](/docs/deploy/)
# Microsoft Entra ID (Azure Active Directory)
Copy link
Contributor

Choose a reason for hiding this comment

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

I think we can remove this explicit heading line and use the default title instead?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

So this is more of an SEO thing. The title front matter is treated as the title tag (what you'd see in the browser tab). If you don't include an H1 like I have, Docusaurus will use the title front matter value as the H1. Specifically for this guide, including both is redundant, but sometimes the H1 should differ from the title (like the code-server guide). I do this out habit to make sure future pages are treated the same.

Copy link
Contributor

Choose a reason for hiding this comment

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

Do you want to update this heading to match the current title then?

content/docs/identity-providers/azure.mdx Outdated Show resolved Hide resolved
content/docs/identity-providers/azure.mdx Outdated Show resolved Hide resolved
content/docs/identity-providers/azure.mdx Outdated Show resolved Hide resolved

If you have an Office 365 account, you can use the account's Azure AD instance instead of creating a new one. To find your Office 365 account's Azure AD instance:
- Install [Pomerium](/docs/deploy/core)
- Create a free [Microsoft 365 administration account](https://www.microsoft.com/en-us/microsoft-365/business/office-365-administration) (or have admin privileges with an existing Microsoft 365 account)
Copy link
Contributor

Choose a reason for hiding this comment

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

I think you sign up for an Azure account?

https://azure.microsoft.com/en-us/free/

Copy link
Contributor Author

@ZPain8464 ZPain8464 Jan 23, 2024

Choose a reason for hiding this comment

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

pagination_next: null
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

This page will help you configure Pomerium to use your Azure Active Directory as an IdP. It assumes you have already [installed Pomerium](/docs/deploy/)
# Microsoft Entra ID (Azure Active Directory)
Copy link
Contributor

Choose a reason for hiding this comment

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

Do you want to update this heading to match the current title then?

@ZPain8464 ZPain8464 merged commit d7a0e38 into main Jan 24, 2024
6 checks passed
@ZPain8464 ZPain8464 deleted the zpain/azure-update branch January 24, 2024 17:16
backport-actions-token bot pushed a commit that referenced this pull request Jan 24, 2024
* partially updates guide

* updates guide through application registration

* updats api permissions section

* updates pomerium configuration section

* updates guide and deletes azure img directory

* fixes precheck failures

* Update content/docs/identity-providers/azure.mdx

Co-authored-by: Kenneth Jenkins <[email protected]>

* Update content/docs/identity-providers/azure.mdx

Co-authored-by: Kenneth Jenkins <[email protected]>

* Update content/docs/identity-providers/azure.mdx

Co-authored-by: Kenneth Jenkins <[email protected]>

* Update content/docs/identity-providers/azure.mdx

Co-authored-by: Kenneth Jenkins <[email protected]>

* Update content/docs/identity-providers/azure.mdx

Co-authored-by: Kenneth Jenkins <[email protected]>

* Update content/docs/identity-providers/azure.mdx

Co-authored-by: Kenneth Jenkins <[email protected]>

* Update content/docs/identity-providers/azure.mdx

---------

Co-authored-by: Kenneth Jenkins <[email protected]>
ZPain8464 added a commit that referenced this pull request Jan 24, 2024
Docs: azure update (#1183)

* partially updates guide

* updates guide through application registration

* updats api permissions section

* updates pomerium configuration section

* updates guide and deletes azure img directory

* fixes precheck failures

* Update content/docs/identity-providers/azure.mdx



* Update content/docs/identity-providers/azure.mdx



* Update content/docs/identity-providers/azure.mdx



* Update content/docs/identity-providers/azure.mdx



* Update content/docs/identity-providers/azure.mdx



* Update content/docs/identity-providers/azure.mdx



* Update content/docs/identity-providers/azure.mdx

---------

Co-authored-by: zachary painter <[email protected]>
Co-authored-by: Kenneth Jenkins <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

docs: Azure Active Directory renamed to Microsoft Entra ID
3 participants