RegistrationResponse
На этой странице, помимо RegistrationResponse, описаны следующие структуры и перечисления:
Результат регистрации пользователя в организации по сертификату методом Register.
message RegistrationResponse {
required RegistrationStatus RegistrationStatus = 1;
optional string BoxId = 2;
optional bytes DataToSign = 3;
}
RegistrationStatus— статус регистрации, принимает значение из перечисления RegistrationStatus.BoxId— идентификатор ящика найденной или созданной организацииDataToSign— данные, которые нужно подписать, чтобы подтвердить владение закрытым ключом сертификата. Представляют собой строку в кодировке UTF8, содержащую идентификаторы пользователя и ящика, отпечаток сертификата и метку времени. Эти данные затем используются в структуре RegistrationConfirmRequest.
RegistrationStatus
Статус регистрации пользователя по сертификату.
enum RegistrationStatus {
Unknown = 0;
AccessIsDenied = 1;
AccessRequestIsRejected = 2;
CertificateOwnershipProofIsRequired = 3;
CertificateIsNotQualified = 4;
RegistrationIsCompleted = 5;
RegistrationIsInProgress = 6;
RegistrationInBranchIsForbidden = 7;
AccessRequestIsPending = 8;
OrganizationNotFound = 9;
}
Описание статусов регистрации
| Статус | Описание | Причины | Возможные действия |
|---|---|---|---|
| Unknown | неизвестное значение | Клиент использует устаревшую версию SDK и не может интерпретировать ответ. | Обновите SDK до последней версии. |
| AccessIsDenied | доступ запрещен | Переданный сертификат не привязан к текущему пользователю или пользователь был удален из этой организации. | Обратитесь в техподдержку или отправьте запрос на доступ в организацию через веб-интерфейс. |
| AccessRequestIsRejected | запрос на доступ отклонен | Администратор организации отклонил запрос на доступ. | Свяжитесь с администратором организации. |
| CertificateOwnershipProofIsRequired | нужно подтвердить владение закрытым ключом | Сертификат привязан к пользователю, но не подтверждено владение пользователем закрытым ключом этого сертификата. | Подпишите данные, содержащиеся в поле DataToSign, и передайте подпись в метод RegisterConfirm, после этого снова вызвите метод Register. Или авторизуйтесь в API по сертификату, по которому происходит регистрация. |
| CertificateIsNotQualified | сертификат не является квалифицированным | Переданный сертификат не является действующим сертифкатом квалифицированной электронной подписи. | Передайте в метод регистрации действующий неотозванный сертификат КЭП. |
| RegistrationIsCompleted | регистрация завершена | Сотрудник зарегистрирован с правами администратора. | Регистрация завершена, текущий пользователь может совершать действия в ящике с идентификатором BoxId. |
| RegistrationIsInProgress | идет процесс регистрации | Запущена асинхронная проверка наличия в ящике действующих администраторов. | Повторите запрос через несколько секунд. |
| RegistrationInBranchIsForbidden | регистрация в филиал невозможна | Организация является частью филиальной сети. Самостоятельная регистрация в такие организации невозможна. | Свяжитесь с администратором организации. |
| AccessRequestIsPending | отправлен запрос на доступ | Отправлен запрос на доступ в организацию. | Дождитесь обработки запроса администратором организации или связатесь с ним самостоятельно. |
| OrganizationNotFound | организация не найдена | Не удалось найти организацию с ИНН переданного сертификата. | Обратитесь в техподдержку. |
См. также
Структура используется:
- в теле ответа метода Register