Yandex Cloud
Search
Contact UsGet started
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • AI for business
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Yandex Identity Hub
    • All guides
    • Subscribing a user to notifications
      • Associating a domain
      • Verifying a domain
      • Getting a list of domains
      • Viewing information about a domain
      • Deleting a domain
  • Access management
  • Pricing policy
  • Terraform reference
  • Audit Trails events
  • Release notes

In this article:

  • Verifying a domain in a user pool
  • Verifying a domain in an identity federation
  1. Step-by-step guides
  2. Managing domains
  3. Verifying a domain

Verifying a domain

Written by
Yandex Cloud
Updated at November 10, 2025
  • Verifying a domain in a user pool
  • Verifying a domain in an identity federation

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 poolVerifying a domain in a user pool

Cloud Center UI
CLI
  1. Log in to Yandex Identity Hub using an administrator or organization owner account.
  2. In the left-hand panel, click User pools and select the user pool.
  3. Select the domain you need to verify.
  4. In the section that opens, you will see the details you will need to pass the domain rights check.
  5. 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.

  1. Confirm that the domain belongs to you:

    1. Go to the DNS records management section on your domain's DNS provider's website:

    2. Add a TXT record with the following parameters:

      • Host or Subdomain: _yandexcloud-challenge.
      • Text or Value: The value field value you got after associating the domain.
    3. Wait for the DNS records to update. The update may take up to 72 hours.

  2. See the description of the CLI command for validating your domain in a user pool:

    yc organization-manager idp userpool domain validate --help
    
  3. Run this command:

    yc organization-manager idp userpool domain validate <pool_ID> <domain> \
      --name <domain>
    

    For example, validate my-domain.ru in my-federation:

    yc organization-manager federation saml validate-domain my-federation \
      --domain my-domain.ru
    

Verifying a domain in an identity federationVerifying a domain in an identity federation

CLI

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.

  1. Confirm that the domain belongs to you:

    1. Go to the DNS records management section on your domain's DNS provider's website.

    2. Add a TXT record with the following parameters:

      • Host or Subdomain: _yandexcloud-challenge.
      • Text or Value: The value field value you got after associating the domain.
    3. Wait for the DNS records to update. The update may take up to 72 hours.

  2. See the description of the CLI command for validating your domain in a federation:

    yc organization-manager federation saml validate-domain --help
    
  3. Run this command:

    yc organization-manager federation saml validate-domain <federation_name_or_ID> \
      --domain <domain>
    

    Where --domain is your domain.

    For example, validate my-domain.ru in my-federation:

    yc organization-manager federation saml validate-domain my-federation \
      --domain my-domain.ru
    

Was the article helpful?

Previous
Associating a domain
Next
Getting a list of domains
© 2025 Direct Cursus Technology L.L.C.