diff --git a/MIGRATION_GUIDE.md b/MIGRATION_GUIDE.md index b7cc2e31f..9f289a04d 100644 --- a/MIGRATION_GUIDE.md +++ b/MIGRATION_GUIDE.md @@ -9,6 +9,7 @@ automated workflows before upgrading. - [Auth0 Global Client](#auth0-global-client) - [Auth0 Tenant Pages](#auth0-tenant-pages) +- [Auth0 Tenant Universal Login](#auth0-tenant-universal-login) #### Auth0 Global Client @@ -115,6 +116,48 @@ resource "auth0_pages" "my_pages" { +#### Auth0 Tenant Universal Login + +The `universal_login` settings on the `auth0_tenant` have been deprecated in favour of managing them through the `auth0_branding` resource. + +To ensure a smooth transition when we eventually remove the capability to manage these settings through the +`auth0_tenant` resource, we recommend proactively migrating to the `auth0_branding` resource. This will help you stay +prepared for future changes. + + + + + + + + + + +
Before (v0.49.0)After (v0.50.0)
+ +```terraform +resource "auth0_tenant" "my_tenant" { + universal_login { + colors { + primary = "#0059d6" + page_background = "#000000" + } + } +} +``` + + + +```terraform +resource "auth0_branding" "my_branding" { + colors { + primary = "#0059d6" + page_background = "#000000" + } +} +``` + +
## Upgrading from v0.48.0 → v0.49.0 diff --git a/docs/data-sources/tenant.md b/docs/data-sources/tenant.md index fbde37b3d..5d826f3d5 100644 --- a/docs/data-sources/tenant.md +++ b/docs/data-sources/tenant.md @@ -39,7 +39,7 @@ data "auth0_tenant" "my_tenant" {} - `session_lifetime` (Number) Number of hours during which a session will stay valid. - `support_email` (String) Support email address for authenticating users. - `support_url` (String) Support URL for authenticating users. -- `universal_login` (List of Object) Configuration settings for Universal Login. (see [below for nested schema](#nestedatt--universal_login)) +- `universal_login` (List of Object) Configuration settings for Universal Login. These configuration settings have been deprecated. Migrate to managing these settings through the `auth0_branding` resource. (see [below for nested schema](#nestedatt--universal_login)) ### Nested Schema for `change_password` diff --git a/docs/resources/tenant.md b/docs/resources/tenant.md index 5a72fa21e..e4a19583a 100644 --- a/docs/resources/tenant.md +++ b/docs/resources/tenant.md @@ -86,7 +86,7 @@ resource "auth0_tenant" "my_tenant" { - `session_lifetime` (Number) Number of hours during which a session will stay valid. - `support_email` (String) Support email address for authenticating users. - `support_url` (String) Support URL for authenticating users. -- `universal_login` (Block List, Max: 1) Configuration settings for Universal Login. (see [below for nested schema](#nestedblock--universal_login)) +- `universal_login` (Block List, Max: 1, Deprecated) Configuration settings for Universal Login. These configuration settings have been deprecated. Migrate to managing these settings through the `auth0_branding` resource. (see [below for nested schema](#nestedblock--universal_login)) ### Read-Only diff --git a/internal/auth0/tenant/resource.go b/internal/auth0/tenant/resource.go index 203fd0629..3e1f46cb3 100644 --- a/internal/auth0/tenant/resource.go +++ b/internal/auth0/tenant/resource.go @@ -346,7 +346,8 @@ func NewResource() *schema.Resource { Optional: true, Computed: true, MaxItems: 1, - Description: "Configuration settings for Universal Login.", + Description: "Configuration settings for Universal Login. These configuration settings have been deprecated. Migrate to managing these settings through the `auth0_branding` resource.", + Deprecated: "These configuration settings have been deprecated. Migrate to managing these settings through the `auth0_branding` resource.", Elem: &schema.Resource{ Schema: map[string]*schema.Schema{ "colors": {