ALTER CERTIFICATE(Transact-SQL)

아티클
11/19/2024

적용 대상: Microsoft Fabric의 SQL Server Azure SQL Database Azure SQL Managed Instance Analytics Platform System(PDW) SQL 데이터베이스

인증서의 프라이빗 키를 암호화하는 데 사용되는 암호를 변경하고, 프라이빗 키를 제거하거나 존재하지 않은 경우 프라이빗 키를 가져옵니다. Service Broker에 대한 인증서의 가용성을 변경합니다.

Transact-SQL 구문 규칙

구문

-- Syntax for SQL Server and Azure SQL Database  
  
ALTER CERTIFICATE certificate_name   
      REMOVE PRIVATE KEY  
    | WITH PRIVATE KEY ( <private_key_spec> )  
    | WITH ACTIVE FOR BEGIN_DIALOG = { ON | OFF }  
  
<private_key_spec> ::=   
      {   
        { FILE = 'path_to_private_key' | BINARY = private_key_bits }  
         [ , DECRYPTION BY PASSWORD = 'current_password' ]  
         [ , ENCRYPTION BY PASSWORD = 'new_password' ]  
      }  
    |  
      {  
         [ DECRYPTION BY PASSWORD = 'current_password' ]  
         [ [ , ] ENCRYPTION BY PASSWORD = 'new_password' ]  
      }

-- Syntax for Parallel Data Warehouse  
  
ALTER CERTIFICATE certificate_name   
{  
      REMOVE PRIVATE KEY  
    | WITH PRIVATE KEY (   
        FILE = '<path_to_private_key>',  
        DECRYPTION BY PASSWORD = '<key password>' )
}

인수

certificate_name
데이터베이스에서 인증서를 식별하는 고유한 이름입니다.

REMOVE PRIVATE KEY
데이터베이스 내에서 더 이상 프라이빗 키를 유지하지 않도록 지정합니다.

WITH PRIVATE KEY 인증서의 프라이빗 키가 SQL Server에 저장되도록 지정합니다.

FILE ='path_to_private_key'
프라이빗 키에 대해 파일 이름을 포함하여 전체 경로를 지정합니다. 이 매개 변수는 로컬 경로이거나 네트워크 위치에 대한 UNC 경로가 될 수 있습니다. 이 파일은 SQL Server 서비스 계정의 보안 컨텍스트 내에서 액세스할 수 있습니다. 이 옵션을 사용할 경우 서비스 계정이 지정된 파일에 액세스할 수 있는지 확인합니다.

파일 이름만 지정하는 경우 파일은 인스턴스의 기본 사용자 데이터 폴더에 저장됩니다. 이 폴더는 SQL Server DATA 폴더일 수도 있고 아닐 수도 있습니다. SQL Server Express LocalDB의 경우 인스턴스의 기본 사용자 데이터 폴더는 인스턴스를 생성한 계정의 %USERPROFILE% 환경 변수에 의해 지정된 경로입니다.

BINARY ='private_key_bits'
적용 대상: SQL Server 2012(11.x) 이상

이진 상수로 지정되는 프라이빗 키 비트입니다. 이러한 비트는 암호화된 형식일 수 있습니다. 암호화된 경우 사용자는 해독 암호를 입력해야 합니다. 이 암호에 대해서는 암호 정책 확인이 수행되지 않습니다. 프라이빗 키 비트는 PVK 파일 형식이어야 합니다.

DECRYPTION BY PASSWORD ='current_password'
프라이빗 키를 해독하는 데 필요한 암호를 지정합니다.

ENCRYPTION BY PASSWORD ='new_password'
데이터베이스에서 인증서의 프라이빗 키를 암호화하는 데 사용되는 암호를 지정합니다. new_password는 SQL Server 인스턴스를 실행하는 컴퓨터의 Windows 암호 정책 요구 사항을 충족해야 합니다. 자세한 내용은 Password Policy을 참조하세요.

ACTIVE FOR BEGIN_DIALOG = { ON | OFF }
Service Broker 대화 기능의 시작자가 인증서를 사용할 수 있게 합니다.

설명

프라이빗 키는 certificate_name으로 지정한 퍼블릭 키와 일치해야 합니다.

파일에 있는 암호가 Null 암호로 보호되는 경우에는 DECRYPTION BY PASSWORD 절을 생략할 수 있습니다.

데이터베이스에 이미 있는 인증서의 프라이빗 키를 가져오는 경우 해당 프라이빗 키는 데이터베이스 마스터 키에 의해 자동으로 보호됩니다. 프라이빗 키를 암호로 보호하려면 ENCRYPTION BY PASSWORD 절을 사용합니다.

REMOVE PRIVATE KEY 옵션을 사용하면 데이터베이스에서 인증서의 프라이빗 키를 삭제할 수 있습니다. 서명 확인에 인증서를 사용할 때 또는 프라이빗 키가 필요 없는 Service Broker 시나리오에서 프라이빗 키를 제거할 수 있습니다. 대칭 키를 보호하는 인증서의 프라이빗 키는 제거하지 마십시오. 인증서로 확인해야 하는 추가 모듈이나 문자열에 서명하거나 인증서로 암호화된 값을 해독하려면 프라이빗 키를 복원해야 합니다.

데이터베이스 마스터 키를 사용하여 프라이빗 키를 암호화한 경우에는 해독 암호를 지정할 필요가 없습니다.

프라이빗 키를 암호화하는 데 사용되는 암호를 변경하려면 FILE 또는 BINARY 절을 지정하지 마세요.

중요

데이터베이스에서 프라이빗 키를 제거하기 전에 복사본을 만들어 보관하십시오. 자세한 내용은 BACKUP CERTIFICATE(Transact-SQL) 및 CERTPRIVATEKEY(Transact-SQL)를 참조하세요.

포함된 데이터베이스에서는 WITH PRIVATE KEY 옵션을 사용할 수 없습니다.

사용 권한

인증서에 대한 ALTER 권한이 필요합니다.

예

A. 인증서의 프라이빗 키 제거

ALTER CERTIFICATE Shipping04   
    REMOVE PRIVATE KEY;  
GO

B. 프라이빗 키를 암호화하는 데 사용된 암호 변경

ALTER CERTIFICATE Shipping11   
    WITH PRIVATE KEY (DECRYPTION BY PASSWORD = '95hkjdskghFDGGG4%',  
    ENCRYPTION BY PASSWORD = '34958tosdgfkh##38');  
GO

C. 데이터베이스의 기존 인증서에 대한 프라이빗 키 가져오기

ALTER CERTIFICATE Shipping13   
    WITH PRIVATE KEY (FILE = 'c:\importedkeys\Shipping13',  
    DECRYPTION BY PASSWORD = 'GDFLKl8^^GGG4000%');  
GO

D. 프라이빗 키 보호를 암호에서 데이터베이스 마스터 키로 변경

ALTER CERTIFICATE Shipping15   
    WITH PRIVATE KEY (DECRYPTION BY PASSWORD = '95hk000eEnvjkjy#F%');  
GO

참고 항목

CREATE CERTIFICATE(Transact-SQL)
DROP CERTIFICATE(Transact-SQL)
BACKUP CERTIFICATE(Transact-SQL)
암호화 계층
EVENTDATA(Transact-SQL)
CERTENCODED(Transact-SQL)
CERTPRIVATEKEY(Transact-SQL)
CERT_ID(Transact-SQL)
CERTPROPERTY(Transact-SQL)

다음을 통해 공유