Skip to content

[Security] Updates docs for enabling Defend access on macOS #2396

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

Open
wants to merge 8 commits into
base: main
Choose a base branch
from

Conversation

natasha-moore-elastic
Copy link
Contributor

@natasha-moore-elastic natasha-moore-elastic commented Aug 4, 2025

Resolves #2101 by adding instructions for approving the ElasticEndpoint system extension for macOS Sequoia.

Instead of creating a new page for macOS Sequoia, I consolidated the existing instructions for Monterey and Ventura with the new instructions for Sequoia into a single page using tabs, since the differences are minimal.

For the removed pages (Enable access for macOS Monterey and Enable access for macOS Ventura and higher), I've changed them to "hidden" in the TOC, replaced the content with a "This page has moved" note, and created redirects in the redirect.yml file.

Previews:

Removed pages:

@natasha-moore-elastic natasha-moore-elastic self-assigned this Aug 4, 2025
Copy link

github-actions bot commented Aug 4, 2025

⚠️ Markdown file changes detected

The following 2 Markdown files were removed in this PR:

  • solutions/security/configure-elastic-defend/enable-access-for-macos-monterey.md
  • solutions/security/configure-elastic-defend/enable-access-for-macos-ventura-higher.md

Action Required

We currently do not have an easy way to implement redirects for removed or renamed files. If possible, please:

  • Keep files whenever possible and hide them from the TOC by using hidden
  • Add a notice at the top of the file indicating that the page has moved with a link to the new location
  • Ensure you've updated redirects.yml accordingly if files must be removed or renamed

Thank you!

Copy link

github-actions bot commented Aug 4, 2025

⚠️ Markdown file changes detected

The following 2 Markdown files were removed in this PR:

  • solutions/security/configure-elastic-defend/enable-access-for-macos-monterey.md
  • solutions/security/configure-elastic-defend/enable-access-for-macos-ventura-higher.md

Action Required

We currently do not have an easy way to implement redirects for removed or renamed files. If possible, please:

  • Keep files whenever possible and hide them from the TOC by using hidden
  • Add a notice at the top of the file indicating that the page has moved with a link to the new location
  • Ensure you've updated redirects.yml accordingly if files must be removed or renamed

Thank you!

Copy link
Contributor

@florent-leborgne florent-leborgne Aug 4, 2025

Choose a reason for hiding this comment

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

I think you can remove these files with the real redirections that you added to the redirects.yml file

Edit: Seeing the automatic comment, I'm not sure , but I thought the redirects system was complete 😅

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I initially removed them and got this message, so I followed what it said 🤷‍♀️

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I can go back and remove them again, but do we have any guidance on when we should remove them vs keep them as hidden?

Copy link
Contributor

Choose a reason for hiding this comment

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

Yeah, noticed this afterwards

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Maybe @elastic/docs-engineering could help confirm the right action here? :)

Copy link
Contributor

Choose a reason for hiding this comment

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

I am probably wrong here, better follow the guidance in the auto-comment

Copy link
Contributor

@florent-leborgne florent-leborgne left a comment

Choose a reason for hiding this comment

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

LGTM!

4. Enter your username and password and click **Modify Settings** to save your changes.
:::

:::{tab-item} Monterey (12.x)
Copy link
Contributor

@florent-leborgne florent-leborgne Aug 4, 2025

Choose a reason for hiding this comment

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

You may want to use :group: and :sync: props so that all of the same items in other sections are also selected when the user clicks

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Nice, that's a cool feature 🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[BUG] Endpoint Security documentation update
2 participants