ru.CryptoPro.JCP.params
Class AlgIdSpec

java.lang.Object
  ru.CryptoPro.JCP.params.AlgIdSpec

All Implemented Interfaces:

AlgIdInterface, java.security.spec.AlgorithmParameterSpec, ParamsInterface

public class AlgIdSpec

extends java.lang.Object

implements AlgIdInterface

Данный класс определяет набор параметров для ключей подписи и обмена.

В этот набор входят:

• идентификатор набора параметров ключа. Идентификатор определяет тип ключа - ключ обмена или ключ подписи, а также алгоритм ЭЦП, которому соответствует ключ - ГОСТ Р 34.10-94 или ГОСТ Р 34.10-2001;
• параметры алгоритма ГОСТ Р 34.10-94 либо ГОСТ Р 34.10-2001 подписи или обмена (в зависимости от идентификатора ключа);
• параметры алгоритма ГОСТ Р 34.11-94 хеширования;
• параметры алгоритма ГОСТ Р 28147-89 шифрования.

Author:

Copyright 2004-2005 Crypto-Pro. All rights reserved.

See Also:

OID

Version:1.0

Field Summary

static OID	OID_19 Идентификатор набора параметров ключа подписи, соответствующего алгоритму ГОСТ Р 34.10-2001.
static OID	OID_20 Идентификатор набора параметров ключа подписи, соответствующего алгоритму ГОСТ Р 34.10-94.
static OID	OID_21 Идентификатор алгоритма шифрования ГОСТ 28147-89.
static OID	OID_3 Идентификатор параметров алгоритма подписи ГОСТ Р 34.10-2001.
static OID	OID_4 Идентификатор алгоритма подписи ГОСТ Р 34.10-94.
static OID	OID_9 Идентификатор алгоритма хеширования ГОСТ Р 34.11-94.
static OID	OID_98 Идентификатор набора параметров ключа обмена, соответствующего алгоритму подписи ГОСТ Р 34.10-2001 и алгориму обмена Диффи-Хелмана.
static OID	OID_99 Идентификатор набора параметров ключа обмена, соответствующего алгоритму подписи ГОСТ Р 34.10-94 и алгориму обмена Диффи-Хелмана.
static java.lang.String	S_OID_19 Строковое представление идентификатора набора параметров ключа подписи, соответствующего алгоритму ГОСТ Р 34.10-2001.
static java.lang.String	S_OID_20 Строковое представление идентификатора набора параметров ключа подписи, соответствующего алгоритму ГОСТ Р 34.10-94.
static java.lang.String	S_OID_21 Строковое представление идентификатора алгоритма шифрования ГОСТ 28147-89.
static java.lang.String	S_OID_3 Строковое представление идентификатора алгоритма подписи ГОСТ Р 34.10-2001.
static java.lang.String	S_OID_4 Строковое представление идентификатора алгоритма подписи ГОСТ Р 34.10-94.
static java.lang.String	S_OID_9 Строковое представление идентификатора алгоритма хеширования ГОСТ Р 34.11-94.
static java.lang.String	S_OID_98 Строковое представление идентификатора набора параметров ключа обмена, соответствующего алгоритму подписи ГОСТ Р 34.10-2001 и алгориму обмена Диффи-Хелмана.
static java.lang.String	S_OID_99 Строковое представление идентификатора набора параметров ключа обмена, соответствующего алгоритму подписи ГОСТ Р 34.10-94 и алгориму обмена Диффи-Хелмана.

Constructor Summary

AlgIdSpec(ru.CryptoPro.JCP.ASN.PKIX1Explicit88.AlgorithmIdentifier id)
Создание объекта AlgIdSpec из ASN-закодированного представления набора параметров ключа.

AlgIdSpec(OID oid)
Создание объекта AlgIdSpec на основе идентификатора параметров ключа.

AlgIdSpec(OID oid, OID signOID, OID digestOID, OID cryptOID)
Создание объекта AlgIdSpec на основе идентификатора параметров ключа, а также идентификаторов параметров алгоритмов подписи (либо обмена), хеширования и шифрования.

AlgIdSpec(OID oid, ParamsInterface signParameters, ParamsInterface digestParameters, ParamsInterface cryptParameters)
Создание объекта AlgIdSpec на основе идентификатора набора параметров ключа и заданных параметров алгоритмов подписи (либо обмена), хеширования и шифрования.

AlgIdSpec(java.lang.String oidName)
Создание объекта AlgIdSpec на основе сторокового представления идентификатора параметров ключа.

Method Summary

ParamsInterface	getCryptParams() Функция возвращает параметры алгоритма шифрования из набора параметров ключа.
java.lang.Object	getDecoded() Функция возращает ASN-закодированное представление набора параметров ключа.
OID	getDefault() Функция возвращает значение идентификатора набора параметров для ключей подписи, установленного в контрольной панели (другими словами, идентификатора по умолчанию).
static OID	getDefaultCryptOID() Функция возвращает идентификатор по умолчанию для параметров алгоритма шифрования ГОСТ 28147-89.
static ParamsInterface	getDefaultCryptParams() Функция возвращает параметры алгоритма шифрования ГОСТ 28147-89 по умолчанию (установленные в контрольной панели).
static ParamsInterface	getDefaultDigestParams() Функция возвращает параметры алгоритма хеширования ГОСТ Р 34.11-94 по умолчанию (установленные в контрольной панели).
static ParamsInterface	getDefaultExchangeParams() Функция возвращает параметры алгоритма обмена ГОСТ Р 34.10-2001 по умолчанию (установленные в контрольной панели).
static OID	getDefaultSignOID(OID oid) Функция возвращает идентификатор по умолчанию для параметров алгоритма подписи (либо обмена), соответствующих передаваемому идентификатору набора параметров для ключа.
static ParamsInterface	getDefaultSignParams() Функция возвращает параметры алгоритма подписи ГОСТ Р 34.10-2001 по умолчанию (установленные в контрольной панели).
static OID	getDHDefault() Функция возвращает значение идентификатора набора параметров для ключей обмена, установленного в контрольной панели (другими словами, идентификатора по умолчанию).
static java.util.Enumeration	getDHNames() Функция получает список строковых представлений допустимых идентификаторов набора параметров для ключей обмена.
static java.util.Enumeration	getDHOIDs() Функция получает список допустимых идентификаторов набора параметров для ключей обмена.
ParamsInterface	getDigestParams() Функция возвращает параметры алгоритма хеширования из набора параметров ключа.
java.lang.String	getNamebyOID(OID oid) Функция возвращает строковое представление идентификатора алгоритма (ЭЦП, хеширования или шифрования) или идентификатора набора параметров для ключей.
OID	getOID() Функция возвращает идентификатор набора параметров ключа.
OID	getOIDbyName(java.lang.String oid) Функция получает идентификатор набора параметров для ключей либо идентификатор алгоритма (ЭЦП, хеширования или шифрования) по его строковому представлению.
java.util.Enumeration	getOIDs() Функция получает список допустимых идентификаторов набора параметров для ключей подписи.
ParamsInterface	getSignParams() Функция возвращает параметры алгоритма подписи (либо обмена) из набора параметров ключа.
void	setDefault(OID def) Функция устанавливает идентификатор набора параметров по умолчанию для ключей подписи.
boolean	setDefaultAvailable() Функция проверки необходимых прав для записи всего набора параметров в контрольную панель.
static void	setDHDefault(OID def) Функция устанавливает идентификатор набора параметров по умолчанию для ключей обмена.
java.lang.String	toString() Функция возвращает строковое представление набора параметров ключа в следующей последовательности: идентификатор параметров, параметры алгоритма подписи (либо обмена), параметры алгоритма хеширования, параметры алгоритма шифрования.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

OID_20

public static final OID OID_20

Идентификатор набора параметров ключа подписи, соответствующего алгоритму ГОСТ Р 34.10-94. Ввиду соглашения генерация ключей с таким идентификатором запрещена (допустимо только чтение из контейнера) Также запрещено создание ЭЦП на таких ключах (допустима только операция проверки ЭЦП).

S_OID_20

public static final java.lang.String S_OID_20

Строковое представление идентификатора набора параметров ключа подписи, соответствующего алгоритму ГОСТ Р 34.10-94. Ввиду соглашения генерация ключей с таким идентификатором запрещена (допустимо только чтение из контейнера). Также запрещено создание ЭЦП на таких ключах (допустима только операция проверки ЭЦП).

OID_19

public static final OID OID_19

Идентификатор набора параметров ключа подписи, соответствующего алгоритму ГОСТ Р 34.10-2001.

S_OID_19

public static final java.lang.String S_OID_19

Строковое представление идентификатора набора параметров ключа подписи, соответствующего алгоритму ГОСТ Р 34.10-2001.

OID_99

public static final OID OID_99

Идентификатор набора параметров ключа обмена, соответствующего алгоритму подписи ГОСТ Р 34.10-94 и алгориму обмена Диффи-Хелмана. Ввиду соглашения генерация ключей с таким идентификатором запрещена (допустимо только чтение из контейнера). Также запрещено создание ЭЦП на таких ключах (допустимы только операции проверки ЭЦП и выработки ключей согласования).

S_OID_99

public static final java.lang.String S_OID_99

Строковое представление идентификатора набора параметров ключа обмена, соответствующего алгоритму подписи ГОСТ Р 34.10-94 и алгориму обмена Диффи-Хелмана. Ввиду соглашения генерация ключей с таким идентификатором запрещена (допустимо только чтение из контейнера). Также запрещено создание ЭЦП на таких ключах (допустимы только операции проверки ЭЦП и выработки ключей согласования).

OID_98

public static final OID OID_98

Идентификатор набора параметров ключа обмена, соответствующего алгоритму подписи ГОСТ Р 34.10-2001 и алгориму обмена Диффи-Хелмана.

S_OID_98

public static final java.lang.String S_OID_98

Строковое представление идентификатора набора параметров ключа обмена, соответствующего алгоритму подписи ГОСТ Р 34.10-2001 и алгориму обмена Диффи-Хелмана.

OID_4

public static final OID OID_4

Идентификатор алгоритма подписи ГОСТ Р 34.10-94. Используется при работе с сертификатами. Генерация сертификатов с таким идентификатором запрещена, допустимо только чтение таких сертификатов. Этот идентификатор не следует путать с идентификаторами параметров алгоритма ГОСТ Р 34.10-94.

S_OID_4

public static final java.lang.String S_OID_4

Строковое представление идентификатора алгоритма подписи ГОСТ Р 34.10-94. Используется при работе с сертификатами. Генерация сертификатов с таким идентификатором запрещена, допустимо только чтение таких сертификатов.

OID_3

public static final OID OID_3

Идентификатор параметров алгоритма подписи ГОСТ Р 34.10-2001. Используется при работе с сертификатами. Этот идентификатор не следует путать с идентификаторами параметров алгоритма ГОСТ Р 34.10-2001.

S_OID_3

public static final java.lang.String S_OID_3

Строковое представление идентификатора алгоритма подписи ГОСТ Р 34.10-2001. Используется при работе с сертификатами.

OID_9

public static final OID OID_9

Идентификатор алгоритма хеширования ГОСТ Р 34.11-94. Этот идентификатор не следует путать с идентификаторами параметров алгоритма ГОСТ Р 34.11-94.

S_OID_9

public static final java.lang.String S_OID_9

Строковое представление идентификатора алгоритма хеширования ГОСТ Р 34.11-94.

OID_21

public static final OID OID_21

Идентификатор алгоритма шифрования ГОСТ 28147-89. Этот идентификатор не следует путать с идентификаторами параметров алгоритма ГОСТ 28147-89.

S_OID_21

public static final java.lang.String S_OID_21

Строковое представление идентификатора алгоритма шифрования ГОСТ 28147-89.

Constructor Detail

AlgIdSpec

public AlgIdSpec(ru.CryptoPro.JCP.ASN.PKIX1Explicit88.AlgorithmIdentifier id)

Создание объекта AlgIdSpec из ASN-закодированного представления набора параметров ключа.

Parameters:

id - ASN-закодированный набор параметров ключа

AlgIdSpec

public AlgIdSpec(OID oid)

Создание объекта AlgIdSpec на основе идентификатора параметров ключа. При таком способе создания набор параметров ключа определяется в соответствии с установленным в контрольной панели для заданного идентификатора набора параметров. Если в качестве параметра передается null, то набор определяется в соответстсвии с установленными в контрольной панели параметрами для ключей подписи.

Parameters:

oid - идентификатор параметров ключа.

AlgIdSpec

public AlgIdSpec(java.lang.String oidName)

Создание объекта AlgIdSpec на основе сторокового представления идентификатора параметров ключа. При таком способе создания набор параметров ключа определяется в соответствии с установленным в контрольной панели для заданного идентификатора набора параметров.

Parameters:

oidName - строковое представление идентификатора параметров ключа.

AlgIdSpec

public AlgIdSpec(OID oid,
                 OID signOID,
                 OID digestOID,
                 OID cryptOID)

Создание объекта AlgIdSpec на основе идентификатора параметров ключа, а также идентификаторов параметров алгоритмов подписи (либо обмена), хеширования и шифрования.

Parameters:

oid - идентификатор параметров ключа.

signOID - идентификатор параметров подписи (либо обмена).

digestOID - идентификатор параметров хешифрования.

cryptOID - идентификатор параметров шифрования.

AlgIdSpec

public AlgIdSpec(OID oid,
                 ParamsInterface signParameters,
                 ParamsInterface digestParameters,
                 ParamsInterface cryptParameters)

Создание объекта AlgIdSpec на основе идентификатора набора параметров ключа и заданных параметров алгоритмов подписи (либо обмена), хеширования и шифрования.

Parameters:

oid - идентификатор параметров ключа.

signParameters - параметры подписи (либо обмена).

digestParameters - параметры хеширования.

cryptParameters - параметры шифрования.

Method Detail

getOID

public OID getOID()

Функция возвращает идентификатор набора параметров ключа.

Specified by:

getOID in interface ParamsInterface

Returns:

идентификатор параметров ключа.

getSignParams

public ParamsInterface getSignParams()

Функция возвращает параметры алгоритма подписи (либо обмена) из набора параметров ключа.

Specified by:

getSignParams in interface AlgIdInterface

Returns:

параметры подписи (либо обмена).

See Also:

DegreeParamsInterface, EllipticParamsInterface

getDigestParams

public ParamsInterface getDigestParams()

Функция возвращает параметры алгоритма хеширования из набора параметров ключа.

Specified by:

getDigestParams in interface AlgIdInterface

Returns:

параметры хеширования.

See Also:

DigestParamsInterface

getCryptParams

public ParamsInterface getCryptParams()

Функция возвращает параметры алгоритма шифрования из набора параметров ключа.

Specified by:

getCryptParams in interface AlgIdInterface

Returns:

параметры шифрования.

See Also:

CryptParamsInterface

getDefaultSignParams

public static ParamsInterface getDefaultSignParams()

Функция возвращает параметры алгоритма подписи ГОСТ Р 34.10-2001 по умолчанию (установленные в контрольной панели).

Returns:

параметры алгоритма подписи по умолчанию.

getDefaultExchangeParams

public static ParamsInterface getDefaultExchangeParams()

Функция возвращает параметры алгоритма обмена ГОСТ Р 34.10-2001 по умолчанию (установленные в контрольной панели).

Returns:

параметры алгоритма обмена по умолчанию.

getDefaultDigestParams

public static ParamsInterface getDefaultDigestParams()

Функция возвращает параметры алгоритма хеширования ГОСТ Р 34.11-94 по умолчанию (установленные в контрольной панели).

Returns:

параметры алгоритма хеширования по умолчанию.

getDefaultCryptParams

public static ParamsInterface getDefaultCryptParams()

Функция возвращает параметры алгоритма шифрования ГОСТ 28147-89 по умолчанию (установленные в контрольной панели).

Returns:

параметры алгоритма шифрования по умолчанию.

getDecoded

public java.lang.Object getDecoded()

Функция возращает ASN-закодированное представление набора параметров ключа.

Specified by:

getDecoded in interface AlgIdInterface

Returns:

ASN-закодированное представление набора параметров ключа

toString

public java.lang.String toString()

Функция возвращает строковое представление набора параметров ключа в следующей последовательности: идентификатор параметров, параметры алгоритма подписи (либо обмена), параметры алгоритма хеширования, параметры алгоритма шифрования.

Returns:

строковое представление набора параметров ключа.

getDefaultSignOID

public static OID getDefaultSignOID(OID oid)

Функция возвращает идентификатор по умолчанию для параметров алгоритма подписи (либо обмена), соответствующих передаваемому идентификатору набора параметров для ключа. Если в качестве идентификатора передается null, то возвращается null.

Parameters:

oid - идентификатор набора параметров

Returns:

идентификатор параметров подписи (либо обмена).

getDefaultCryptOID

public static OID getDefaultCryptOID()

Функция возвращает идентификатор по умолчанию для параметров алгоритма шифрования ГОСТ 28147-89.

Returns:

идентификатор по умолчанию параметров алгоритма шифрования

setDefault

public void setDefault(OID def)

Функция устанавливает идентификатор набора параметров по умолчанию для ключей подписи.

Specified by:

setDefault in interface ParamsInterface

Parameters:

def - новый идентификатор набора параметров по умолчанию для ключей подписи.

getDefault

public OID getDefault()

Функция возвращает значение идентификатора набора параметров для ключей подписи, установленного в контрольной панели (другими словами, идентификатора по умолчанию). На данный момент единственным допустимым таким идентификатором является OID_19.

Specified by:

getDefault in interface ParamsInterface

Returns:

идентификатор набора параметров для ключей подписи по умолчанию.

setDefaultAvailable

public boolean setDefaultAvailable()

Функция проверки необходимых прав для записи всего набора параметров в контрольную панель.

Specified by:

setDefaultAvailable in interface ParamsInterface

Returns:

true, если прав достаточно, false - в противном случае.

getNamebyOID

public java.lang.String getNamebyOID(OID oid)

Функция возвращает строковое представление идентификатора алгоритма (ЭЦП, хеширования или шифрования) или идентификатора набора параметров для ключей.

Specified by:

getNamebyOID in interface ParamsInterface

Parameters:

oid - идентификатор

Returns:

строковое представление идентификатора.

getOIDbyName

public OID getOIDbyName(java.lang.String oid)

Функция получает идентификатор набора параметров для ключей либо идентификатор алгоритма (ЭЦП, хеширования или шифрования) по его строковому представлению.

Specified by:

getOIDbyName in interface ParamsInterface

Parameters:

oid - строковое представление

Returns:

идентификатор , соответствующий строковому представлению.

getOIDs

public java.util.Enumeration getOIDs()

Функция получает список допустимых идентификаторов набора параметров для ключей подписи.

Specified by:

getOIDs in interface ParamsInterface

Returns:

список допустимых идентификаторов набора параметров для ключей подписи.

setDHDefault

public static void setDHDefault(OID def)

Функция устанавливает идентификатор набора параметров по умолчанию для ключей обмена.

Parameters:

def - новый идентификатор по умолчанию для ключей обмена.

getDHDefault

public static OID getDHDefault()

Функция возвращает значение идентификатора набора параметров для ключей обмена, установленного в контрольной панели (другими словами, идентификатора по умолчанию). На данный момент единственным допустимым таким идентификатором является OID_98.

Returns:

идентификатор набора параметров для ключей обмена по умолчанию.

getDHOIDs

public static java.util.Enumeration getDHOIDs()

Функция получает список допустимых идентификаторов набора параметров для ключей обмена.

Returns:

список допустимых идентификаторов набора параметров для ключей обмена.

getDHNames

public static java.util.Enumeration getDHNames()

Функция получает список строковых представлений допустимых идентификаторов набора параметров для ключей обмена.

Returns:

список строковых представлений допустимых идентификаторов набора параметров для ключей обмена.