Setting up SSO¶

Single Sign-on (SSO) supports integrating authentication for your Nextmv accounts with a SSO provider using SAML. Nextmv supports the following Identity Providers (IDP):

• Auth0
• Microsoft Entra
• Okta

Use the SSOConfiguration.new method to set up SSO configuration for your Nextmv organization.

import os

from nextmv import cloud
from nextmv.cloud import SSOConfiguration

client = cloud.Client(api_key=os.getenv("NEXTMV_API_KEY"))
SSOConfiguration.new(
    client=client,
    metadata_url="<METADATA_URL>",
    enabled=True,
    allow_non_domain_users=True,
)

uv run main.py

Using enabled=True will create the SSO configuration and enable it. You can also use the following methods to manage SSO enablement:

• SSOConfiguration.enable: enables SSO for your Nextmv organization.
• SSOConfiguration.disable: disables SSO for your Nextmv organization.

Go the reference section to see all the available parameters for each method under the SSOConfiguration class.