Перейти к основному содержимому

CertificateList

Список сертификатов.

message CertificateList {
repeated CertificateInfoV2 Certificates = 1;
}

message CertificateInfoV2 {
required string Thumbprint = 1;
required CertificateType Type = 2;
optional sfixed64 ValidFrom = 3;
optional sfixed64 ValidTo = 4;
optional sfixed64 PrivateKeyValidFrom = 5;
optional sfixed64 PrivateKeyValidTo = 6;
optional string OrganizationName = 7;
optional string Inn = 8;
optional string UserFirstName = 9;
optional string UserMiddleName = 10;
optional string UserLastName = 11;
optional string UserShortName = 12;
optional bool IsDefault = 13;
optional CertificateSubjectType SubjectType = 14;
repeated CertificateUsage Usages = 15;
optional DssCertificateType DssType = 16;
}

enum CertificateType {
Unknown = 0;
Token = 1;
DSS = 2;
KonturCertificate = 3;
Goskey = 4;
}

enum CertificateSubjectType {
UnknownCertificateSubjectType = 0;
LegalEntity = 1;
IndividualEntity = 2;
PhysicalPerson = 3;
}

enum CertificateUsage {
UnknownUsage = 0;
KonturCertificateUsage = 1;
TokenUsage = 2;
DssUsage = 3;
}

enum DssCertificateType {
UnknownDssType = 0;
MyDss = 1;
KSignServer = 2;
KSignRutoken = 3;
KSignMobile = 4;
}
  • Certificates — список сертификатов. Каждый элемент списка представлен структурой CertificateInfoV2 с полями:
    • Thumbprint — отпечаток сертификата пользователя.
    • Type — тип сертификата, принимает значения из перечисления CertificateType:
      • Unknown — неизвестное значение;
      • Token — железный носитель;
      • DSS — сертификат myDSS и Контур.Подпись;
      • KonturCertificate — сертификат облачной неквалифицированной электронной подписи (ОНЭП);
      • Goskey — сертификат «Госключ».
    • ValidFrom — дата начала действия сертификата, представляет собой целое число тиков (100-наносекундных интервалов), прошедших с момента времени 00:00:00 01.01.0001.
    • ValidTo — дата окончания действия сертификата, представляет собой целое число тиков (100-наносекундных интервалов), прошедших с момента времени 00:00:00 01.01.0001.
    • PrivateKeyValidFrom — дата начала действия закрытого ключа, представляет собой целое число тиков (100-наносекундных интервалов), прошедших с момента времени 00:00:00 01.01.0001.
    • PrivateKeyValidTo — дата окончания действия закрытого ключа, представляет собой целое число тиков (100-наносекундных интервалов), прошедших с момента времени 00:00:00 01.01.0001.
    • OrganizationName — наименование организации, на которую выдан сертификат.
    • Inn — ИНН организации, на которую выдан сертификат.
    • UserFirstName — имя пользователя.
    • UserMiddleName — отчество пользователя.
    • UserLastName — фамилия пользователя.
    • UserShortName — краткое имя пользователя в формате «Фамилия И.О.».
    • IsDefault — признак того, что сертификат выбран для работы по умолчанию. Например, от этого зависит автоматическое подписание извещений о получений в веб-интерфейсе Диадока.
    • SubjectType — тип владельца сертификата, принимает значения из перечисления CertificateSubjectType:
      • UnknownCertificateSubjectType — неизвестное значение;
      • LegalEntity — представитель юридического лица;
      • IndividualEntity — индивидуальный предприниматель;
      • PhysicalPerson — физическое лицо.
    • Usages — список типов сертификата. Может быть пустым. Каждый элемент списка принимает значение из перечисления CertificateUsage:
      • UnknownUsage — неизвестное значение: возвращается в случае ошибки при определении типа сертификата;
      • KonturCertificateUsage — Контур.Сертификат;
      • TokenUsage — сертификат на железном носителе;
      • DssUsage — мобильный сертификат.
    • DssType — тип мобильного сертификата. Имеет смысл только в случае, когда Usages = DssUsage. Принимает значение из перечисления DssCertificateType:
      • UnknownDssType — сертификат не мобильный;
      • MyDss — MyDss-сертификат;
      • KSignServer — КПодпись.Сервер;
      • KSignRutoken — КПодпись.Рутокен;
      • KSignMobile — КПодпись.Мобильный.

С помощью значений параметров Usages и DssType можно определить тип сертификата:

  • если CertificateType = Token и Usages = TokenUsage; DssUsage — то это сертификат Рутокен ЭЦП 3.0 (NFC);
  • если CertificateType = Token, а Usages не содержит элемента DssUsage — то это сертификат Рутокен ЭЦП 2.0;
  • если CertificateType = KonturCertificate, а Usages = KonturCertificateUsage — то это Контур.Сертификат;
  • если CertificateType = DSS, а Usages = DssUsage — то это мобильный сертификат;

См. также

Структура используется:

Оцените материал страницы

Нашли ошибку или столкнулись с проблемой?

СКБ Контурс 1988 года