Verifying a domain
Note
This feature is at the Preview stage.
You can use only verified domains to add users.
To validate a domain, you must be its owner and have the credentials to modify DNS records on the website of your domain’s DNS provider.
Verifying a domain in a user pool
- Log in to Yandex Identity Hub
using an administrator or organization owner account. - In the left-hand panel, click
User pools and select the user pool. - Select the domain you need to verify.
- In the section that opens, you will see the details you will need to pass the domain rights check.
- After completing the verification, click Confirm.
If you do not have the Yandex Cloud CLI installed yet, install and initialize it.
By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also set a different folder for any specific command using the --folder-name or --folder-id parameter.
-
Confirm that the domain belongs to you:
-
Go to the DNS records management section on your domain's DNS provider's website:
-
Add a TXT record with the following parameters:
- Host or Subdomain:
_yandexcloud-challenge. - Text or Value: The
valuefield value you got after associating the domain.
- Host or Subdomain:
-
Wait for the DNS records to update. The update may take up to 72 hours.
-
-
See the description of the CLI command for validating your domain in a user pool:
yc organization-manager idp userpool domain validate --help -
Run this command:
yc organization-manager idp userpool domain validate <pool_ID> <domain> \ --name <domain>For example, validate
my-domain.ruinmy-federation:yc organization-manager federation saml validate-domain my-federation \ --domain my-domain.ru
Verifying a domain in an identity federation
If you do not have the Yandex Cloud CLI installed yet, install and initialize it.
By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also set a different folder for any specific command using the --folder-name or --folder-id parameter.
-
Confirm that the domain belongs to you:
-
Go to the DNS records management section on your domain's DNS provider's website.
-
Add a TXT record with the following parameters:
- Host or Subdomain:
_yandexcloud-challenge. - Text or Value: The
valuefield value you got after associating the domain.
- Host or Subdomain:
-
Wait for the DNS records to update. The update may take up to 72 hours.
-
-
See the description of the CLI command for validating your domain in a federation:
yc organization-manager federation saml validate-domain --help -
Run this command:
yc organization-manager federation saml validate-domain <federation_name_or_ID> \ --domain <domain>Where
--domainis your domain.For example, validate
my-domain.ruinmy-federation:yc organization-manager federation saml validate-domain my-federation \ --domain my-domain.ru