Manage your SSO connection
Port allows company admins to configure SSO (single sign-on) directly from the Port app.
This self-serve flow guides you through connecting your identity provider (IdP) to Port.
Prerequisites
- This feature is available for enterprise accounts only.
- Your account must use the multi-organization architecture.
- You must be a company admin to configure SSO.
- You need access to your identity provider's admin console to create and configure applications.
- Have your connection name ready - you will likely need it during the setup process. It follows the format
company-<companyID>-SSO, where the company ID can be found in the Credentials modal, under the Organization tab → Company ID (use only the ID portion, not the full string).
Setup
Follow these steps to configure SSO for your company:
Step 1: Initiate the SSO setup
- Click your profile picture
and select Settings.
- Open the SSO tab.
- Click the Set up SSO connection button.
A unique SSO setup link will be generated for you, it will be valid for 5 hours after you first open it, or 5 days if you don't open it. You can copy and save the link to complete the setup later.
Step 2: Configure your identity provider
After clicking the continue button, you will be guided to configure the SSO connection.
The following identity providers are supported:
The setup process is guided by Auth0's self-service assistant, which walks you through each step including creating an application in your IdP, configuring the connection, mapping claims, and testing the SSO integration. For a detailed example walkthrough of the assistant flow, see the Auth0 Self-Service SSO documentation.
Complete the configuration in your identity provider's admin console following the on-screen instructions.
Step 3: Monitor the connection status
While configuring your IdP, the Port UI displays the current status of your SSO connection:
| Status indicator | Description |
|---|---|
| The setup process is in progress or hasn't been verified yet. | |
| The SSO connection was successfully created and verified. | |
| The SSO connection setup failed. See the troubleshooting section below for resolution options. |
Once you have completed the configuration in your identity provider, the window should update automatically. Otherwise click the Setup is Done button in Port to indicate that the process is finished.
Manage the connection
After the SSO connection is successfully established, you can configure the following options:
-
Set group filters - Click
Set Group Filtersto control which IdP groups sync into Port teams. You can use regular expressions (RegEx) to define allowed and blocked group patterns.Group filter playgroundThe group filter configuration in Port is a playground for testing your RegEx patterns. Your patterns will be saved, but the groups themselves are not modified. Group management should always be done in your identity provider's admin console. Groups that are already synced to Port will appear by default in the playground, allowing you to test how your filters would affect them.
-
Session settings - Click
Session Settingsto configure the maximum session duration (in minutes) for your SSO users. -
Edit connection - Click
Edit Connectionto open the Auth0 management interface where you can modify your SSO configuration, including adding or managing domains associated with your SSO connection as well as managing the client secret. -
Inactivity timeout - Configure a timeout value that automatically signs a user out of the Port application after a period of inactivity. The timeout is off by default, and company admins can configure it directly. See session timeout for the full configuration steps.
UI onlyThe inactivity timeout only applies to the Port UI. A user who is signed out of the UI due to inactivity can still interact with Port through the API or MCP, since these interfaces are not affected by this setting.
Verify your domain
After the SSO connection is successfully established, verify your company domains to automatically direct users to your SSO portal.
This enhances security and improves the login experience by directing users to your identity provider based on the domain in their email address, thus preventing unwanted creation of organizations or users.
To verify your domain:
-
Click
Edit Connectionto open the Auth0 management interface. -
Click
Domain configuration. -
Under the
Add domaintab, enter the domain you want to verify, then clickAdd domain.
Require login using SSO
After you verify your domains, you can require your users to sign in through your identity provider. Turn on Require login using SSO in the SSO tab of your organization settings.
When the setting is on:
- Everyone with an email address on a verified domain must sign in through your identity provider.
- Users with an email address outside your verified domains can't sign in, whether they use a password, a social login, or SSO. This includes existing members.
- Password sign-ups on your verified domains are refused.
- You can't invite a user with an email address outside your verified domains.
Turn on Require login using SSO only after you verify your domains. If no domain is verified, nobody can sign in with the setting on.
To turn the setting off, switch Require login using SSO off. This allows other login methods; SSO-only users must set a password through the sign-up flow before they can sign in with email and password.
Remove or disable the SSO connection
Port keeps all existing users and their assigned roles when you remove or disable an SSO connection. You must be a company admin to manage the connection in Settings → SSO.
Turning off Require login using SSO allows other login methods without removing the SSO connection. If this setting is on, turn it off before users complete email and password sign-up, since it blocks password sign-ups on your verified domains.
If you have only signed in through SSO, your account has no stored password for email and password login. To set one:
-
Open the Port application and start the email and password sign-up flow.
-
Enter the same email address you used for SSO and choose a password.
-
Complete the sign-up flow, then sign in with your email and password. You keep your existing Port user and assigned roles.
Limitations
- Terraform is not supported for self-serve SSO setup.
Troubleshooting
If you encounter one of the following issues, use the table to identify and resolve it:
| Error | Cause | Resolution |
|---|---|---|
| Connection not created | The SSO connection was not created in Auth0. | Click Start Again to generate a new setup URL and repeat the configuration process or click Setup is Done once you complete the process. |
| Linking failed | The SSO provider is connected, but linking to the company in Port failed. | Contact Port's support team for assistance. |
FAQ
No. Port supports only one SSO provider per company at a time.
No. You need to delete the existing connection and start the setup process from the beginning. There is no migration path between SSO providers.
A company admin can configure SSO for an enterprise account that uses Port's multi-organization architecture. The admin also needs access to the identity provider's administration console.
Port's self-serve SSO flow supports SAML and OpenID Connect (OIDC). Select the setup path that matches the protocol and identity provider your organization uses.