[Документация Yandex Cloud](../../index.md) > [Yandex Identity Hub](../index.md) > [Пошаговые инструкции](index.md) > Аутентификация > Работа с OS Login > Создать профиль OS Login

# Создать профиль OS Login

[Профили OS Login по умолчанию](../concepts/os-login.md#os-login-profiles) автоматически создаются для всех пользователей организации Yandex Identity Hub при [включении доступа по OS Login](os-login-access.md). При этом у каждого пользователя или [сервисного аккаунта](../../iam/concepts/users/service-accounts.md) может быть одновременно несколько профилей OS Login — вы можете создавать такие профили вручную. Разные профили позволяют подключаться к [ВМ](../../compute/concepts/vm.md) или узлам [кластеров](../../managed-kubernetes/concepts/index.md#kubernetes-cluster) Kubernetes от имени разных локальных пользователей этих ВМ или узлов Kubernetes.

Для сервисных аккаунтов профили OS Login не создаются автоматически. Чтобы подключаться к ВМ или узлу Kubernetes от имени сервисного аккаунта, вручную создайте для него профиль OS Login.

{% note info %}

Минимально необходимая роль, позволяющая просматривать список профилей OS Login пользователей — [роль](../security/index.md#organization-manager-osLogins-viewer) `organization-manager.osLogins.viewer`, назначенная на организацию. Информацию о других ролях, позволяющих просматривать список профилей OS Login, читайте в разделе [Управление доступом в Yandex Identity Hub](../security/index.md#service-roles).

{% endnote %}

Чтобы создать профиль OS Login:

{% list tabs group=instructions %}

- Интерфейс Cloud Center {#cloud-center}

  1. Войдите в сервис [Yandex Identity Hub](https://kz.center.yandex.cloud/organization) с учетной записью администратора или владельца организации.

      При необходимости [переключитесь](manage-organizations.md#switch-to-another-org) на нужную организацию или федерацию.

  1. На панели слева выберите ![icon-users](../../_assets/console-icons/person.svg) **Пользователи**.
 
  1. В списке выберите пользователя, для которого вы хотите создать профиль OS Login.
  
      При необходимости воспользуйтесь фильтром или поиском.
  
  1. На странице пользователя перейдите на вкладку **Профили OS Login** и нажмите кнопку **Создать профиль**. В открывшемся окне:

      1. Введите имя пользователя в ОС, которое будет присвоено пользователю организации или сервисному аккаунту при подключении к ВМ. Должно быть уникальным в пределах системы.

          {% note info %}
          
          Имя пользователя может содержать латинские буквы, цифры, дефис и подчеркивание, но должно начинаться с буквы, цифры или подчеркивания. Длина от 1 до 32 символов.
          
          {% endnote %}

      1. В поле **Идентификатор (UID)** задайте уникальный числовой идентификатор пользователя (UID). Он должен быть уникальным в пределах системы.

          {% note warning %}
          
          Нельзя допускать совпадения UID профиля OS Login и системных профилей операционной системы. Если вы задаете UID вручную, используйте значения в диапазоне от `1002` до `2^63 - 1`, чтобы избежать такого совпадения.
          
          {% endnote %}

      1. (Опционально) В поле **Домашняя директория** укажите путь к домашнему каталогу пользователя.

      1. (Опционально) В поле **Оболочка по умолчанию** укажите путь к исполняемому файлу командной оболочки.

      1. Нажмите кнопку **Создать**.

- CLI {#cli}

  Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), [установите и инициализируйте его](../../cli/quickstart.md#install).

  По умолчанию используется каталог, указанный при [создании](../../cli/operations/profile/profile-create.md) профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду `yc config set folder-id <идентификатор_каталога>`. Также для любой команды вы можете указать другой каталог с помощью параметров `--folder-name` или `--folder-id`. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

  1. Посмотрите описание команды CLI для создания профиля OS Login:

      ```bash
      yc organization-manager oslogin profile create --help
      ```

  1. Получите идентификатор нужной организации:

      ```bash
      yc organization-manager organization list
      ```

      Результат:

      ```text
      +----------------------+-------------------------+-----------------------+--------+
      |          ID          |          NAME           |         TITLE         | LABELS |
      +----------------------+-------------------------+-----------------------+--------+
      | bpf1smsil5q0******** | sample-organization-1   | My organization       |        |
      | bpf2c65rqcl8******** | sample-organization-new | New organization      |        |
      +----------------------+-------------------------+-----------------------+--------+
      ```

  1. Получите идентификатор нужного пользователя, указав идентификатор организации, к которой он относится:

      ```bash
      yc organization-manager user list \
        --organization-id <идентификатор_организации>
      ```

      Результат:

      ```text
      +----------------------+----------+-------------------+---------------+-----------------------+
      |          ID          | USERNAME |       EMAIL       | FEDERATION ID | LAST AUTHENTICATED AT |
      +----------------------+----------+-------------------+---------------+-----------------------+
      | rser11gh89el******** | user01   | user01@example.ru |               |                       |
      | mber02hy54km******** | user02   | user02@example.ru |               |                       |
      +----------------------+----------+-------------------+---------------+-----------------------+
      ```

      Если вы хотите создать профиль OS Login для сервисного аккаунта, [получите](../../iam/operations/sa/get-id.md) идентификатор нужного сервисного аккаунта.

  1. Создайте профиль OS Login для выбранного пользователя или сервисного аккаунта:

      ```bash
      yc organization-manager oslogin profile create \
        --organization-id <идентификатор_организации> \
        --subject-id <идентификатор_пользователя_или_сервисного_аккаунта> \
        --login <логин> \
        --uid <числовой_идентификатор> \
        --home-directory <путь_к_домашнему_каталогу> \
        --shell <путь_до_исполняемого_файла_командной_оболочки>
      ```

      Где:

      * `--organization-id` — полученный ранее идентификатор организации.
      * `--subject-id` — полученный ранее идентификатор пользователя или сервисного аккаунта.
      * `--login` — имя пользователя в ОС, которое будет присвоено ему при подключении к ВМ. Должно быть уникальным в пределах системы.

          {% note info %}
          
          Имя пользователя может содержать латинские буквы, цифры, дефис и подчеркивание, но должно начинаться с буквы, цифры или подчеркивания. Длина от 1 до 32 символов.
          
          {% endnote %}

      * `--uid` — уникальный числовой идентификатор пользователя (UID). Должен быть уникальным в пределах системы.

          {% note warning %}
          
          Нельзя допускать совпадения UID профиля OS Login и системных профилей операционной системы. Если вы задаете UID вручную, используйте значения в диапазоне от `1002` до `2^63 - 1`, чтобы избежать такого совпадения.
          
          {% endnote %}

      * `--home-directory` — путь к домашнему каталогу пользователя на ВМ. Необязательный параметр. Значение по умолчанию — `/home/<имя_пользователя>`.
      * `--shell` — путь к исполняемому файлу командной оболочки на ВМ. Необязательный параметр. Значение по умолчанию — `/bin/bash`.

      Результат:

      ```text
      id: aje6ddct3de5********
      organization_id: bpf1smsil5q0********
      subject_id: rser11gh89el********
      login: new-os-login
      uid: "100500"
      home_directory: home/username
      shell: bin/bash
      ```

- API {#api}

  Воспользуйтесь методом REST API [createProfile](../api-ref/OsLogin/createProfile.md) для ресурса [OsLogin](../api-ref/OsLogin/index.md) или вызовом gRPC API [OsLoginService/CreateProfile](../api-ref/grpc/OsLogin/createProfile.md).

{% endlist %}

Создать профиль OS Login сервисного аккаунта можно только с помощью [Yandex Cloud CLI](../cli-ref/oslogin/profile/create.md) или [API](../api-ref/OsLogin/createProfile.md).

#### Полезные ссылки {#see-also}

* [Включить доступ по OS Login](os-login-access.md)
* [Добавить SSH-ключ](add-ssh.md)
* [Подключиться к виртуальной машине по OS Login](../../compute/operations/vm-connect/os-login.md)
* [Подключиться к узлу Kubernetes через OS Login](../../managed-kubernetes/operations/node-connect-oslogin.md)
* [Использовать сервисный аккаунт с профилем OS Login для управления ВМ с помощью Ansible](../tutorials/sa-oslogin-ansible.md)