--- metadata: - name: generator content: Diplodoc Platform v5.50.6 alternate: - https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/invite.md - https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/invite.md --- > **Documentation Index:** Fetch the complete configuration index at https://sourcecraft.dev/portal/docs/ru/llms.txt # Отправить и принять приглашение в организацию SourceCraft ## Отправить приглашение {#send-invite} {% note warning %} Для отправки приглашения в организацию у вас должна быть роль не ниже [Администратор организации](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/index.md#organization-manager-admin). {% endnote %} Вы можете пригласить пользователя с [аккаунтом на Яндексе](https://id.yandex.ru/) в [организацию](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/index.md#org) SourceCraft. {% note tip %} Для авторизации корпоративных аккаунтов в SourceCraft с помощью системы единого входа (Single Sign-On, SSO) вы можете использовать [SAML-совместимые федерации удостоверений](https://yandex.cloud/ru/docs/organization/concepts/add-federation) Yandex Cloud. {% endnote %} 1. Откройте [главную страницу](https://sourcecraft.dev) SourceCraft. 1. На вкладке **Домой** перейдите в раздел **Организации**. 1. Выберите организацию, в которую хотите пригласить пользователя. 1. На странице организации в разделе **Люди** перейдите в секцию **Участники и роли**. 1. В правом верхнем углу нажмите **Новый участник**. 1. В открывшемся окне выберите принцип, по которому пользователю будет отправлено приглашение в организацию: {% list tabs group=invite-type %} - Логин {#login} 1. В поле **Приглашаемые пользователи** начните вводить публичное имя, например `Иванов Иван`, или никнейм, например `ivanov-2000`, и выберите один из предложенных вариантов. Вы можете добавить несколько пользователей. 1. (Опционально) Назначьте [роль](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/index.md#roles-list) для приглашаемых пользователей: 1. Нажмите **Добавить роль**. 1. В выпадающем списке **Роль** выберите необходимую [роль](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/index.md#roles-list). 1. В выпадающем списке **Срок действия инвайта** выберите срок, в течение которого пользователи должны принять приглашение в организацию. 1. Нажмите **Пригласить в организацию**. Пользователю придет письмо с приглашением вступить в вашу организацию. Он может это сделать, перейдя по ссылке в письме. {% note info %} У зарегистрированных пользователей приглашение также будет отображаться на [главной странице](https://sourcecraft.dev) SourceCraft. {% endnote %} - E-mail {#e-mail} 1. В поле **Приглашаемые люди** введите адрес электронной почты пользователя и нажмите **Добавить email**. Вы можете добавить несколько адресов. 1. (Опционально) Назначьте [роль](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/index.md#roles-list) для приглашаемых пользователей: 1. Нажмите **Добавить роль** 1. В выпадающем списке **Роль** выберите необходимую [роль](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/index.md#roles-list). 1. В выпадающем списке **Срок действия инвайта** выберите срок, в течение которого пользователи должны принять приглашение в организацию. 1. Нажмите **Пригласить в организацию**. Пользователю придет письмо с приглашением вступить в вашу организацию. Он может это сделать, перейдя по ссылке в письме. {% note info %} У зарегистрированных пользователей приглашение также будет отображаться на [главной странице](https://sourcecraft.dev) SourceCraft. {% endnote %} - Ссылка {#link} Вы можете сгенерировать уникальные _ссылки-приглашения_ для произвольных пользователей. Каждая ссылка имеет свой срок действия и может быть использована только один раз. Этот способ полезен, если вам неизвестны логины или электронные почты пользователей, а также может быть использован для автоматизации назначения ролей и предоставления доступа к репозиторию. Перейдя по ссылке, пользователь может принять ваше приглашение. После этого он получит доступ к вашей организации и репозиториям в ней. Чтобы сгенерировать ссылки-приглашения: 1. (Опционально) Назначьте [роль](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/index.md#roles-list) для приглашаемого пользователя: 1. Нажмите **Добавить роль** 1. В выпадающем списке **Роль** выберите необходимую [роль](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/index.md#roles-list). 1. В выпадающем списке **Срок действия инвайта** выберите срок, в течение которого будет действовать ссылка. 1. В поле **Количество** укажите количество уникальных ссылок-приглашений. 1. В поле **Префикс** укажите префикс для ссылок-приглашений, например `team-sourcecraft`. 1. Нажмите **Пригласить в организацию**. 1. В открывшемся окне скопируйте ссылки в буфер обмена или скачайте в виде файла и закройте окно. {% note warning %} После закрытия окна сгенерированные ссылки будут недоступны. Но вы можете создать новые. {% endnote %} 1. Отправьте ссылки-приглашения пользователям. - Мульти-ссылка {#multi-link} Вы можете сгенерировать одну _мульти-ссылку_, по которой к организации сможет присоединиться один или несколько пользователей. Создать мульти-ссылку можно как для заранее известных пользователей, так и для произвольных. Мульти-ссылка работает через [сервисный аккаунт](https://yandex.cloud/ru/docs/iam/concepts/users/service-accounts) Yandex Identity and Access Management с [ролью](https://yandex.cloud/ru/docs/iam/roles-reference#organization-manager-passportUserAdmin) `organization-manager.passportUserAdmin`. Вы можете выбрать существующий сервисный аккаунт или создать новый. Чтобы сгенерировать мульти-ссылку: 1. В выпадающем списке **Срок действия инвайта** выберите срок, в течение которого будет действовать мульти-ссылка. 1. (Опционально) В поле **Лимит пользователей** укажите максимальное число пользователей, которые смогут принять мульти-ссылку. Если поле не заполнено, число пользователей не ограничено. 1. (Опционально) В поле **Уникальное имя ссылки** укажите уникальное имя мульти-ссылки. Если поле не заполнено, имя будет сгенерировано автоматически. 1. (Опционально) Назначьте [роль](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/index.md#roles-list) для приглашаемых пользователей: 1. Нажмите **Добавить роль**. 1. В выпадающем списке **Роль** выберите необходимую роль. 1. В блоке **Могут принять** выберите ограничение для приглашения: * **Все** — приглашение может принять любой пользователь. * **Некоторые** — приглашение могут принять только определенные пользователи: * (Опционально) **Пользователи SourceCraft** — начните вводить публичное имя, например `Иванов Иван`, или никнейм, например `ivanov-2000`, и выберите одного из предложенных пользователей. Вы можете добавить несколько пользователей. * (Опционально) **Логины Яндекса** — введите логин пользователя и нажмите **Добавить логин**. Вы можете добавить несколько пользователей. 1. В блоке **Сервисный аккаунт** выберите вариант: * **Автоматически** — в Yandex Cloud автоматически будет создан новый сервисный аккаунт с [ролью](https://yandex.cloud/ru/docs/iam/roles-reference#organization-manager-passportUserAdmin) `organization-manager.passportUserAdmin`. * **Выбрать существующий** — выберите [сервисный аккаунт](https://yandex.cloud/ru/docs/iam/concepts/users/service-accounts) Yandex Identity and Access Management, от имени которого будут создаваться приглашения. 1. Нажмите **Пригласить в организацию**. 1. В открывшемся окне скопируйте мульти-ссылку в буфер обмена и закройте окно. {% note warning %} После закрытия окна сгенерированная мульти-ссылка будет недоступна. Но вы можете создать новую. {% endnote %} 1. Отправьте мульти-ссылку пользователям. {% endlist %} ## Принять приглашение {#accept-invite} {% list tabs %} - Зарегистрированный пользователь 1. Выполните действия в зависимости от того, как вы получили приглашение: * **Письмо от SourceCraft**: откройте его и нажмите **Открыть приглашение**. * **Ссылка**: перейдите по ней. 1. Чтобы посмотреть информацию об организации, в которую вы приглашены, на открывшейся странице нажмите **Посмотреть организацию**. 1. Чтобы принять приглашение, нажмите **Принять приглашение**. - Новый пользователь 1. Выполните действия в зависимости от того, как вы получили приглашение: * **Письмо от SourceCraft**: откройте его и нажмите **Принять приглашение**. * **Ссылка**: перейдите по ней. 1. На открывшейся странице нажмите **Принять**. 1. Войдите с помощью [Яндекс ID](https://id.yandex.ru/). Если у вас еще нет Яндекс ID, [зарегистрируйтесь](https://yandex.ru/support/id/ru/authorization/registration.html). Если для входа на Яндекс вы используете профиль в социальной сети, [заведите логин и пароль](https://passport.yandex.ru/passport?mode=postregistration&create_login=1). 1. Подтвердите выбор аккаунта для добавления в организацию. 1. [Завершите](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/registration.md) регистрацию. {% endlist %} ## Работа с приглашениями с помощью API {#api} Для автоматизации процесса работы с приглашениями доступен [REST API SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/api-start.md). Например, вы можете встроить процесс выдачи приглашений на сайт или в свою систему управления доступом. Подробнее на странице [Organization | Invites](https://api.sourcecraft.tech/docs/index.html#tag/Organization-or-Invites). {% note warning %} Аутентификация в API SourceCraft для работы с приглашениями возможна только с помощью [IAM-токена](https://yandex.cloud/ru/docs/iam/concepts/authorization/iam-token) Yandex Identity and Access Management. Подробнее на странице [Получение IAM-токена](https://yandex.cloud/ru/docs/iam/operations/iam-token/create). {% endnote %} ### Создать приглашение в организацию с помощью API {#api-create-invite} ```bash export IAM_TOKEN= curl \ --request POST \ --url "https://api.sourcecraft.tech/orgs/<слаг_организации>/invites" \ --header "Authorization: Bearer $IAM_TOKEN" \ --header "Content-Type: application/json" \ --data '{ "invitees": [ { "email": "<почта_пользователя>" }, { "slug": "<слаг_пользователя_1>" }, { "alias": "<текстовая_запись_для_идентификации>" }, { "slug": "<слаг_пользователя_2>" } ], "ttl_in_days": 1 }' | jq ``` Где: * `invitees` — список приглашаемых пользователей и принцип, по которому пользователю будет отправлено приглашение: * для приглашения конкретных пользователей используйте один из параметров: * `email` — почта пользователя. Можно приглашать, как зарегистрированных в SourceCraft, так и новых пользователей. * `slug` — слаг пользователя в SourceCraft. Только для зарегистрированных пользователей SourceCraft. * для приглашения произвольного пользователя используйте параметр `alias` — приглашение по одноразовой ссылке. Содержит текстовую запись для идентификации приглашения, например `my-first-invite`. * `ttl_in_days` — срок действия приглашения в днях. Результат: ```json { "operation_id": "cq9gajzloslj********", "status_url": "/operations/create-invites/id:cq9gajzloslj********", "status": "scheduled", "created_at": "2026-01-23T07:42:03.062925Z", "modified_at": "2026-01-23T07:42:03.062925Z" } ``` Операция выполняется асинхронно. Сохраните ее идентификатор (`operation_id`), чтобы получить информацию о статусе выполнения. Подробнее на странице [Organization | Invites](https://api.sourcecraft.tech/docs/index.html#tag/Organization-or-Invites). ### Получить информацию об операции создания приглашения с помощью API {#api-get-invite} ```bash export IAM_TOKEN=<персональный_токен> curl \ --request GET \ --url "https://api.sourcecraft.tech/operations/create-invites/id:<идентификатор_операции>" \ --header "Authorization: Bearer $IAM_TOKEN" \ --header "Content-Type: application/json" ``` Результат: ```json { "operation_id": "cq9gajzloslj********", "status_url": "operations/create-invites/id:cq9gajzloslj********", "status": "success", "created_at": "2026-01-23T07:42:03.062925Z", "modified_at": "2026-01-23T07:42:09.612256Z", "response": { "invites": [ { "id": "bpf65vedallc********", "email": "<почта_пользователя>", "alias": "", "invite_link": "", "status": "pending", "subject": { "type": "invitee", "id": "ajeth710l8gi********" }, "created_at": "1970-01-01T00:00:00Z", "expires_at": "1970-01-01T00:00:00Z" }, { "id": "bpf4q13jhnod********", "email": "", "alias": "", "invite_link": "", "invitee": { "id": "01971bf5-6751-7eea-a07f-2e29********", "slug": "<слаг_пользователя_1>" }, "status": "pending", "subject": { "type": "invitee", "id": "ajehmssc34ob********" }, "created_at": "1970-01-01T00:00:00Z", "expires_at": "1970-01-01T00:00:00Z" }, { "id": "bpfrvnq2qd81********", "email": "", "alias": "<текстовая_запись_для_идентификации>", "invite_link": "https://sourcecraft.dev/me/accept-invite/9emq5q98ym4cJU********", "status": "pending", "subject": { "type": "invitee", "id": "ajebuh02o909********" }, "created_at": "2026-02-05T07:34:20.736642Z", "expires_at": "2026-02-06T07:34:20.673905Z" } ], "errors": [ { "invitee": { "email": "", "slug": "<слаг_пользователя_2>", "alias": "" }, "error_code": "InviteeHasAlreadyJoined", "message": "Invited user is already a member" } ] } } ``` Где: * `status` — статус приглашения. * `invite_link` — одноразовая ссылка-приглашение для произвольного пользователя. Доступна только с типом приглашения `alias`. {% note warning %} Ссылка-приглашение отображается только один раз. В дальнейшем получить ее будет невозможно. Но можно создать новую. {% endnote %} * `errors` — ошибки при создании приглашения, например если пользователь уже является участником организации. Подробнее на странице [Get invitation creation operation status (By Operation ID)](https://api.sourcecraft.tech/docs/index.html#tag/Organization-or-Operation/operation/GetOrganizationInvitesOperationByID). ### Вывести список активных приглашений с помощью API {#api-list-invites} Приглашение является активным, если пользователь его еще не принял. ```bash export IAM_TOKEN=<персональный_токен> curl \ --request GET \ --url "https://api.sourcecraft.tech/orgs/<слаг_организации>/invites" \ --header "Authorization: Bearer $IAM_TOKEN" \ --header "Content-Type: application/json" ``` Результат: ```json { "invites": [ { "id": "bpf65vedallc********", "email": "<почта_пользователя>", "alias": "", "invite_link": "", "status": "pending", "subject": { "type": "invitee", "id": "ajeth710l8gi********" }, "created_at": "2026-01-23T07:42:06.938436Z", "expires_at": "2026-01-24T07:42:06.847107Z" } ], "next_page_token": "" } ``` Подробнее на странице [List Organization Invitations](https://api.sourcecraft.tech/docs/index.html#tag/Organization-or-Invites/operation/ListOrganizationInvites). #### Полезные ссылки {#see-also} * [Управление доступом в SourceCraft](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/index.md) * [Назначить роль пользователю](https://sourcecraft.dev/portal/docs/ru/sourcecraft/security/bind.md)