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

New Aruba Orchestrator Integration #12027

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

Conversation

jazzyj123
Copy link

This integration guide details how to configure authentik as a SAML identity provider for Aruba Orchestrator, allowing centralized authentication and role-based access control. It involves setting up SAML mappings in authentik and configuring Aruba Orchestrator to accept SAML assertions from authentik for user login.

@jazzyj123 jazzyj123 requested a review from a team as a code owner November 14, 2024 17:13
Copy link

netlify bot commented Nov 14, 2024

Deploy Preview for authentik-docs ready!

Name Link
🔨 Latest commit f152fef
🔍 Latest deploy log https://app.netlify.com/sites/authentik-docs/deploys/67367ccaad0fde0008a2dcd4
😎 Deploy Preview https://deploy-preview-12027--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 site configuration.

Copy link

netlify bot commented Nov 14, 2024

Deploy Preview for authentik-storybook canceled.

Name Link
🔨 Latest commit f152fef
🔍 Latest deploy log https://app.netlify.com/sites/authentik-storybook/deploys/67367ccaeca45100086048f9

Added Aruba Orchestrator to the sidebar. 

Signed-off-by: jazzyj123 <[email protected]>
Copy link
Author

@jazzyj123 jazzyj123 left a comment

Choose a reason for hiding this comment

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

Updated sidebarIntegrations.js to include Aruba Orchestator in the networking section.

- **Name**: Authentik
- **Username Attribute**: http://schemas.goauthentik.io/2021/02/saml/username
- **Issuer URL**: https://arubaorchestrator.company/gms/rest/authentication/saml2/consume
- **SSO Endpoint**: https://authentik.company/application/saml/sporch/sso/binding/init/
Copy link
Contributor

Choose a reason for hiding this comment

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

sporch should be replaced with something like <slug configured earlier>

1. Log into the Aruba Orchestrator
2. Create a new Remote Authentication Server under **Orchestrator** -> **Authentication** -> **Add New Server**
- **Type**: SAML
- **Name**: Authentik
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
- **Name**: Authentik
- **Name**: authentik

authentik should be lowercased


## Verification

1. Go to `https://arubaorchestrator.company` using Incognito mode.
Copy link
Contributor

Choose a reason for hiding this comment

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

I don't think it's needed to specify the usage of Incognito Mode


1. Go to `https://arubaorchestrator.company` using Incognito mode.
2. Click **Log In Using Authentik** on the login screen.
3. Authorize with authentik.
Copy link
Contributor

Choose a reason for hiding this comment

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

I don't think clicking a button and logging in needs two different steps


## authentik Configuration

Insert Service configuration
Copy link
Contributor

Choose a reason for hiding this comment

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

??

Copy link
Author

Choose a reason for hiding this comment

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

Thanks for the laser sharp review. I've made all the requested changes and a few more.

sidebar_label: Aruba Orchestrator
---

# Service Name
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
# Service Name
# Aruba Orchestrator

@tanberry
Copy link
Contributor

Thanks so much @jazzyj123 for this contribution! I'll give it a review (looks like 4d62 already caught most things) and hopefully we can get it merged after any requested changes are made. Thanks again!

@tanberry
Copy link
Contributor

Oh, also @jazzyj123 it looks like you'll need to run make website or npm run prettier and then push again, please... the build failed on that linter.

Copy link

codecov bot commented Nov 14, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 92.61%. Comparing base (bcb91d2) to head (4243a33).
Report is 1 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main   #12027      +/-   ##
==========================================
- Coverage   92.66%   92.61%   -0.06%     
==========================================
  Files         761      761              
  Lines       37863    37863              
==========================================
- Hits        35085    35065      -20     
- Misses       2778     2798      +20     
Flag Coverage Δ
e2e 49.16% <ø> (-0.11%) ⬇️
integration 24.90% <ø> (ø)
unit 90.18% <ø> (+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.

New Aruba Orchestrator Integration v2

Signed-off-by: jazzyj123 <[email protected]>
@jazzyj123
Copy link
Author

@tanberry @4d62 - I've made all the changes, I hope this is enough. Best Regards.

jazzyj123

This comment was marked as duplicate.

had a \ character which was failing build.

Signed-off-by: jazzyj123 <[email protected]>
Copy link
Contributor

@4d62 4d62 left a comment

Choose a reason for hiding this comment

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

just this little thing, other than that it looks good to me. thanks for your contribution to authentik. tana will need to give final "ok" as I am not a maintainer.


- `arubaorchestrator.company` is the FQDN of the Aruba Orchestrator install.
- `authentik.company` is the FQDN of the authentik install.
- `ssl.certificate` is the name of the SSL certificate used to sign outgoing responses.
Copy link
Contributor

Choose a reason for hiding this comment

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

If it's an SSL certificate, it shouldn't be formatted as a domain. If I were you, I would remove this line and refer to the certificate directly in the documentation

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.

3 participants