OPEN SYMMETRIC KEY (Transact-SQL)
Область применения: SQL Server
База данных SQL Azure
Управляемый экземпляр SQL Azure
Azure Synapse Analytics
Расшифровывает симметричный ключ и делает его доступным для использования.
Соглашения о синтаксисе Transact-SQL
Примечание.
Этот синтаксис не поддерживается бессерверным пулом SQL в Azure Synapse Analytics.
Синтаксис
OPEN SYMMETRIC KEY Key_name DECRYPTION BY <decryption_mechanism>
<decryption_mechanism> ::=
CERTIFICATE certificate_name [ WITH PASSWORD = 'password' ]
|
ASYMMETRIC KEY asym_key_name [ WITH PASSWORD = 'password' ]
|
SYMMETRIC KEY decrypting_Key_name
|
PASSWORD = 'decryption_password'
Примечание.
Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.
Аргументы
Key_name
Имя симметричного ключа, который нужно открыть.
CERTIFICATE certificate_name
Имя сертификата, закрытый ключ которого будет использоваться для расшифровки симметричного ключа.
ASYMMETRIC KEY asym_key_name
Имя асимметричного ключа, закрытый ключ которого будет использоваться для расшифровки симметричного ключа.
WITH PASSWORD ='password'
Пароль, который использовался для шифрования закрытого ключа сертификата или асимметричного ключа.
SYMMETRIC KEY decrypting_key_name
Имя симметричного ключа, который будет использоваться для расшифровки открываемого симметричного ключа.
PASSWORD ='password'
Пароль, использовавшийся для защиты симметричного ключа.
Замечания
Открытые симметричные ключи привязаны к сеансу, а не к контексту безопасности. Открытый ключ останется доступным, пока не будет явно закрыт или сеанс не будет прерван. Если открыт симметричный ключ, после чего произошло переключение контекста, ключ останется открытым и будет доступным в олицетворенном контексте. Одновременно можно открыть несколько ключей. Сведения о симметричных ключах доступны в представлении каталога sys.openkeys (Transact-SQL).
Если симметричный ключ был зашифрован другим ключом, сначала необходимо открыть этот ключ.
Если симметричный ключ уже открыт, то запрос является запросом NO_OP.
Если пароль, сертификат или ключ для расшифровки симметричного ключа неверен, запрос завершается сбоем.
Симметричные ключи, созданные из поставщиков шифрования, не могут быть открыты. Операции шифрования и расшифровки, для которых используется симметричный ключ этого типа, выполняются успешно без инструкции OPEN, поскольку открытие и закрытие ключа осуществляется поставщиком шифрования.
Разрешения
Участник должен обладать некоторыми разрешениями на ключ и не должен иметь запрета на разрешение VIEW DEFINITION для ключа. Дополнительные требования зависят от механизма расшифровки:
DECRYPTION BY CERTIFICATE: разрешение CONTROL на сертификат и пароль, который шифрует закрытый ключ сертификата;
DECRYPTION BY ASYMMETRIC KEY: разрешение CONTROL на асимметричный ключ и знание пароля, который шифрует закрытый ключ сертификата;
DECRYPTION BY PASSWORD: знание одного из паролей, использованного для шифрования симметричного ключа.
Примеры
А. Открытие симметричного ключа с помощью сертификата
Следующий пример иллюстрирует открытие симметричного ключа SymKeyMarketing3
и его расшифровку с помощью закрытого ключа сертификата MarketingCert9
.
USE AdventureWorks2022;
OPEN SYMMETRIC KEY SymKeyMarketing3
DECRYPTION BY CERTIFICATE MarketingCert9;
GO
B. Открытие симметричного ключа с помощью другого симметричного ключа
Следующий пример иллюстрирует открытие симметричного ключа MarketingKey11
и его расшифровку с помощью симметричного ключа HarnpadoungsatayaSE3
.
USE AdventureWorks2022;
-- First open the symmetric key that you want for decryption.
OPEN SYMMETRIC KEY HarnpadoungsatayaSE3
DECRYPTION BY CERTIFICATE sariyaCert01;
-- Use the key that is already open to decrypt MarketingKey11.
OPEN SYMMETRIC KEY MarketingKey11
DECRYPTION BY SYMMETRIC KEY HarnpadoungsatayaSE3;
GO
См. также
CREATE SYMMETRIC KEY (Transact-SQL)
ALTER SYMMETRIC KEY (Transact-SQL)
CLOSE SYMMETRIC KEY (Transact-SQL)
DROP SYMMETRIC KEY (Transact-SQL)
Иерархия средств шифрования
Расширенное управление ключами (EKM)