amplication / docs

Amplication docs
https://docs.amplication.com
Apache License 2.0
17 stars 62 forks source link

📖 Documentation: SSO #293

Closed GreenMachine01 closed 1 year ago

GreenMachine01 commented 1 year ago

I think we can have a short page/section that explains we support SSO and mentioning its part of the Enterprise plan

Single Sign-On (SSO) Support for Amplication Accounts Amplication understands the significance of a streamlined login process for your organization's members. To enhance the security and convenience of accessing your Amplication account, we offer Single Sign-On (SSO) support.

What is Single Sign-On (SSO)? Single Sign-On (SSO) is an authentication process that enables users to access multiple applications or services with a single set of credentials. This means that you won't need to remember multiple passwords or log in repeatedly to different services within your organization's ecosystem. Once authenticated via SSO, you will gain access to all the connected services without the need for additional logins.

Who Can Use SSO with Amplication? SSO integration for Amplication accounts is exclusively available to our Enterprise plan users. By choosing our Enterprise plan, your organization can benefit from streamlined access to Amplication through your preferred SSO provider, ensuring both convenience and security.

How to Enable SSO for Your Amplication Account To enable Single Sign-On (SSO) for your Amplication account:

  1. Contact Us for an Upgrade: If you're interested in using the SSO feature, please reach out to us to upgrade your account to the Enterprise Plan.
  2. Setup & Integration: Once your account is upgraded, our team will handle the SSO setup and integration for you. It's as simple as that! We're here to ensure a smooth and hassle-free experience for our Enterprise users.

For any questions or additional support, feel free to reach out to our dedicated team.

dericksozo commented 1 year ago

Hi @GreenMachine01, can you please provide more details on how this works?

If I'm understanding, there's needs to be a specific email account associated with an Enterprise plan account? I tried signing in with the email associated with my Enterprise account for testing purposes, but I see the following error:

Image

GreenMachine01 commented 1 year ago

@dericksozo SSO is just a method to log in to your Amplication user account. your user account might be connected to several workspaces. some of these workspaces might be Free, Pro, or Enterprise.

We do offer the SSO login only to Enterprise Plan members. in order to be able to use this login method we at Amplication first need to add you as a User on our side of the SSO login which I assume we didn't do for you. If you want to understand how it works it is a pretty straightforward flow

Step1 - provide your email which is listed on our side as having SSO login access. if your email is not recognized by us you will see an error message.

Step2 - If you are verified by the SSO authenticator you will move automatically into your account. if you are not approved for the SSO you will need to authenticate via the SSO first and then will be able to proceed into Amplication

https://en.wikipedia.org/wiki/Single_sign-on

dericksozo commented 1 year ago

Hey @GreenMachine01, I'm handling this PR in #349.

Right now, I think the best place to put this is in its own How To article. I couldn't find another place where it would naturally fit. But, that makes me think we should create a more general page outlining the differences between Free, Pro, and Enterprise. We currently only have the Git Sync Plan Differences page.

GreenMachine01 commented 1 year ago

I don't think this feature belongs on a how-to page. There is no real how to here for the user to do. It might be its own page under the enterprise features section or something like that