rskeymgmt 유틸리티(SSRS)rskeymgmt Utility (SSRS)

중요한 보고서 서버 데이터를 무단 액세스로부터 보호하는 데 사용할 대칭 키를 추출, 복원, 생성 및 삭제합니다.Extracts, restores, creates, and deletes the symmetric key used to protect sensitive report server data against unauthorized access. 이 유틸리티를 사용하여 수평적 확장(Scale-out) 배포에서 보고서 서버 인스턴스를 결합할 수도 있습니다.This utility is also used to join report server instances in a scale-out deployment. 보고서 서버 확장 배포 란 하나의 보고서 서버 데이터베이스를 공유하는 여러 보고서 서버 인스턴스를 말합니다.A report server scale-out deployment refers to multiple report server instances that share a single report server database.

구문Syntax


rskeymgmt {-?}  
{–eextract}  
{–aapply}  
{-ddeleteall}  
{–srecreatekey}  
{–rremoveinstancekey}  
{-jjoinfarm}  
{-iinstance}  
{-ffile}  
{-pencryptionpassword}  
{-mremotecomputer}  
{-ninstancenameofremotecomputer}  
{-uadministratoruseraccount}  
{-vadministratorpassword}  
{-ttrace}  

인수Arguments

-?-?
rskeymgmt 인수의 구문을 표시합니다.Displays the syntax of rskeymgmt arguments.

-e-e
파일로 복사할 수 있도록 보고서 서버 인스턴스의 데이터를 암호화 및 해독하는 데 사용할 대칭 키를 추출합니다.Extracts the symmetric key used to encrypt and decrypt data for the report server instance so that you can copy it to a file.

이 인수는 값을 가지지 않습니다.This argument does not take a value. 그러나 압축 풀기를 완료하려면 명령줄에 추가 인수를 포함해야 합니다.However, you must include additional arguments on the command line to complete the extraction. 지정해야 할 인수에는 -f-p인수가 있습니다.The arguments that you must specify include -f and-p.

-a-a
기존 대칭 키를 암호로 보호된 백업 파일에 제공한 복사본으로 바꿉니다.Replaces an existing symmetric key with a copy that you provide in a password protected backup file. 대칭 키의 모든 인스턴스가 업데이트됩니다.All instances of the symmetric key are updated.

이 인수는 값을 가지지 않습니다.This argument does not take a value. 그러나 적용된 키가 포함된 파일을 선택하려면 명령줄에 추가 인수를 포함해야 합니다.However, you must include additional arguments on the command line to select the file that contains the key to be applied. 지정할 수 있는 인수에는 -f-p인수가 있습니다.The arguments that you can specify include -f and-p.

-d-d
모든 대칭 키 인스턴스를 삭제하고 보고서 서버 데이터베이스에서 암호화된 모든 데이터를 삭제합니다.Deletes all symmetric key instances and all encrypted data in a report server database. 이 인수는 값을 가지지 않습니다.This argument does not take a value.

-s-s
새 대칭 키를 생성하고 이 키를 사용하여 암호화된 모든 내용을 다시 암호화합니다.Generates a new symmetric key and re-encrypts all encrypted content using the new key. 대칭 키의 모든 인스턴스가 다시 생성됩니다.All instances of the symmetric key are regenerated.

-j-j
로컬 보고서 서버 인스턴스에서 사용하는 보고서 서버 데이터베이스를 공유하도록 원격 보고서 서버 인스턴스를 구성합니다.Configures a remote report server instance to share the report server database that is used by the local report server instance.

-r installationID-r installationID
특정 보고서 서버 인스턴스에 대한 대칭 키 정보를 제거합니다. 이에 따라 수평적 확장 배포에서 보고서 서버도 제거됩니다.Removes the symmetric key information for a specific report server instance, thereby removing the report server from a scale-out deployment. installationID 는 RSReportserver.config 파일에 포함된 GUID 값입니다.The installationID is a GUID value that can be found in the RSReportserver.config file.

-f file-f file
대칭 키의 백업 복사본을 저장하는 파일의 정규화된 경로를 지정합니다.Specifies a fully qualified path to the file that stores a backup copy of the symmetric keys.

rskeymgmt -e의 경우 대칭 키가 지정한 파일에 기록됩니다.For rskeymgmt -e, the symmetric key is written to the file you specify.

rskeymgmt -a의 경우 파일에 저장된 대칭 키 값이 보고서 서버 인스턴스에 적용됩니다.For rskeymgmt -a, the symmetric key value stored in the file is applied to the report server instance.

-p password-p password
-f의 경우 필수 인수입니다. 대칭 키를 백업하거나 적용하는 데 사용할 암호를 지정합니다.(Required for -f) Specifies the password used to back up or apply a symmetric key. 이 값은 비워 둘 수 없습니다.This value cannot be empty.

-i-i
로컬 보고서 서버 인스턴스를 지정합니다.Specifies a local report server instance. 기본 SQL ServerSQL Server 인스턴스에 보고서 서버를 설치한 경우 이 인수는 옵션입니다. -i 의 기본값은 MSSQLSERVER입니다.This argument is optional if you installed the report server on the default SQL ServerSQL Server instance (the default value for -i is MSSQLSERVER). 보고서 서버를 명명된 인스턴스로 설치한 경우 -i 가 필요합니다.If you installed the report server as a named instance, -i is required.

-m-m
보고서 서버 수평적 확장 배포에 결합하는 보고서 서버 인스턴스를 호스팅하는 원격 컴퓨터의 이름을 지정합니다.Specifies the name of the remote computer that hosts the report server instance you are joining to the report server scale-out deployment. 네트워크에서 식별할 수 있는 컴퓨터 이름을 사용합니다.Use the name of the computer that identifies it on your network.

-n
원격 컴퓨터의 보고서 서버 인스턴스 이름을 지정합니다.Specifies the name of the report server instance on a remote computer. 기본 SQL ServerSQL Server 인스턴스에 보고서 서버를 설치한 경우 이 인수는 옵션입니다. -n 의 기본값은 MSSQLSERVER입니다.This argument is optional if you installed the report server on the default SQL ServerSQL Server instance (the default value for -n is MSSQLSERVER). 보고서 서버를 명명된 인스턴스로 설치한 경우 -n 가 필요합니다.If you installed the report server as a named instance, -n is required.

-u useraccount-u useraccount
수평적 확장 배포에 결합하는 원격 컴퓨터의 관리자 계정을 지정합니다.Specifies the administrator account on the remote computer that you are joining to the scale-out deployment. 계정을 지정하지 않으면 현재 사용자의 자격 증명이 사용됩니다.If an account is not specified, the credentials of the current user are used.

-v password-v password
-u의 경우 필수 인수입니다. 확장 배포에 포함할 원격 컴퓨터의 관리자 계정 암호를 지정합니다.(Required for -u) Specifies the password of an administrator account on the remote computer that you want to join to the scale-out deployment.

-t trace-t trace
추적 로그에 오류 메시지를 출력합니다.Outputs error messages to the trace log. 이 인수는 값을 가지지 않습니다.This argument does not take a value. 자세한 내용은 Report Server Service Trace Log을 참조하세요.For more information, see Report Server Service Trace Log.

PermissionsPermissions

이 도구를 실행하려면 로컬 관리자 권한이 있어야 하며 보고서 서버를 호스팅하는 컴퓨터에서 로컬로 실행해야 합니다.You must be a local administrator to run the tool, and you must run it locally on the computer that hosts the report server. rskeymgmt 유틸리티는 로컬 보고서 서버 Windows 인스턴스에 사용할 수 있습니다. 이 유틸리티는 보고서 서버 Windows 서비스의 원격 인스턴스에 연결할 수 없으므로 원격 보고서 서버 인스턴스의 암호화 키를 관리하는 데 사용할 수 없습니다.The rskeymgmt utility works with the local Report Server Windows instance (the utility cannot connect to remote instances of the Report Server Windows service so it cannot be used to manage the encryption keys of a remote report server instance).

참고

-u-v 인수를 사용하는 경우 원격 컴퓨터에 대해 관리자 권한이 있는 계정을 지정해야 합니다.If you are using the -u and -v arguments, be sure to specify an account that has administrator permissions on the remote computer.

Examples

다음 예에서는 rskeymgmt를 사용하는 방법을 보여 줍니다.The following examples illustrate ways of using rskeymgmt. 다음 예에서는 암호화 키를 추출, 복원 및 삭제하는 방법과 보고서 서버 수평적 확장 배포를 구성하는 방법을 보여 줍니다.The following examples show how to extract, restore, and delete encryption keys, and how to configure a report server scale-out deployment.

암호화 키 추출Extracting Encryption Keys

이 예에서는 암호화 키의 백업 복사본을 만들고 플로피 디스크의 암호로 보호된 파일에 저장하는 방법을 보여 줍니다.This example shows how to create a backup copy of the encryption key and save it to a password-protected file on a floppy disk. 보고서 서버를 명명된 인스턴스로 설치한 경우 -i 인수를 추가합니다.If the report server is installed as a named instance, add the -i argument.

rskeymgmt -e -f a:\backupkey\keys -p <password>  

암호화 키 복원Restoring Encryption Keys

이 예에서는 암호화 키를 바꾸는 방법을 보여 줍니다.This example shows how to replace the encryption key. 암호화 키의 백업 복사본 위치와 이 파일의 잠금을 해제하는 암호를 지정해야 합니다.You must specify the location of the backup copy of the key and the password that unlocks the file.

rskeymgmt -a -f a:\backupkey\keys -p <password>  

암호화 키 및 암호화된 내용 삭제Deleting Encryption Keys and Encrypted Content

이 예에서는 보고서 서버에 저장된 모든 암호화 키를 삭제하는 방법을 보여 줍니다.This example shows how to delete all encryption keys stored in a report server. 보고서 서버 수평적 확장 배포로 설치한 경우 이 배포에 포함된 모든 보고서 서버 인스턴스의 암호화 키가 삭제됩니다.If your installation is a report server scale-out deployment, the encryption keys for all report server instances that are included in the deployment will be deleted. 암호화 키를 삭제하면 보고서 서버 데이터베이스에서 암호화된 기존 값도 삭제됩니다.Deleting an encryption key also deletes any existing encrypted values in the report server database. 암호화된 내용에 대한 자세한 내용은 암호화된 보고서 서버 데이터 저장(SSRS 구성 관리자)을 참조하세요.For more information about encrypted content, see Store Encrypted Report Server Data (SSRS Configuration Manager).

rskeymgmt -d  

원격 보고서 서버의 명명된 인스턴스를 수평적 확장 배포에 결합Joining a Remote Report Server Named Instance to a Scale-out Deployment

이 예에서는 원격 컴퓨터에 설치된 보고서 서버 인스턴스를 보고서 서버 수평적 확장 배포에 추가하는 방법을 보여 줍니다.This example shows how to add a report server instance that is installed on a remote computer to a report server scale-out deployment. 공유되는 데이터베이스를 사용하도록 이미 구성된 컴퓨터 중 하나에서 명령을 실행해야 합니다.You must run the command on one of the computers that is already configured to use the shared database. 명령 인수는 수평적 확장 배포에 포함할 원격 보고서 서버 인스턴스를 지정합니다.The command arguments specify the remote report server instance you want to join to the scale-out deployment.

rskeymgmt -j -m <remotecomputer> -n <namedreportserverinstance> -u <administratoraccount> -v <administratorpassword>  

참고

보고서 서버 수평적 확장 배포란 여러 보고서 서버 인스턴스가 같은 보고서 서버 데이터베이스를 공유하는 배포 모델을 말합니다.A report server scale-out deployment refers to a deployment model where multiple report server instances share the same report server database. 보고서 서버 데이터베이스에 대칭 키를 저장하는 모든 보고서 서버 인스턴스에서 이 데이터베이스를 사용할 수 있습니다.A report server database can be used by any report server instance that stores its symmetric keys in the database. 예를 들어 보고서 서버 데이터베이스에 3개의 보고서 서버 인스턴스에 대한 키 정보가 포함된 경우 세 인스턴스는 모두 같은 수평적 확장 배포의 멤버로 간주됩니다.For example, if a report server database contains key information for three report server instances, all three instances are considered to members of the same scale-out deployment.

같은 컴퓨터에서 보고서 서버 인스턴스 조인Joining Report Server Instances on the Same Computer

같은 컴퓨터에 설치된 여러 보고서 서버 인스턴스에서 확장 배포를 만들 수 있습니다.You can create a scale-out deployment from multiple report server instances that are installed on the same computer. 로컬로 설치된 보고서 서버 인스턴스를 조인하는 경우에는 -u-v 인수를 설정하지 마세요.Do not set the -u and -v arguments if you are joining report server instances that are installed locally. -u-v 인수는 원격 컴퓨터에서 인스턴스를 조인하는 경우에만 사용됩니다.The -u and -v arguments are used only when you are joining an instance from a remote computer. 로컬인 경우 이러한 인수를 지정하면 "로컬 연결에 대해 사용자 자격 증명을 사용할 수 없습니다" 오류가 발생합니다.If you specify the arguments, you will get the following error: "User credentials cannot be used for local connections."

다음 예에서는 여러 로컬 인스턴스를 사용하여 확장 배포를 만드는 구문을 보여 줍니다.The following example illustrates the syntax for creating a scale-out deployment using multiple local instances. 이 예제에서는 < initializedinstance>은 보고서 서버 데이터베이스를 사용 하도록 이미 초기화 된 인스턴스 이름 및 < newinstance>은 배포에 추가 하려면 인스턴스 이름:In this example, <initializedinstance> is the name of an instance that is already initialized to use the report server database, and <newinstance> is the name of the instance that you want to add to the deployment:

rskeymgmt -j -i <initializedinstance> -m <computer name> -n <newinstance>  

수평적 확장 배포에서 단일 보고서 서버의 암호화 키 제거Removing Encryption Keys for a Single Report Server in a Scale-out Deployment

이 예에서는 보고서 서버 수평적 확장 배포에서 단일 보고서 서버의 암호화 키를 제거하는 방법을 보여 줍니다.This example shows how to remove the encryption keys for a single report server in a report server scale-out deployment. 이 키는 보고서 서버 데이터베이스에서 제거됩니다.The keys are removed from the report server database. 보고서 서버 인스턴스의 키가 제거되면 이 보고서 서버 인스턴스에서 데이터베이스의 암호화된 데이터에 더 이상 액세스할 수 없으며 수평적 확장 배포에서 효과적으로 제거됩니다.Once the keys for that report server instance are removed, that report server instance can no longer access encrypted data in the database, effectively removing it from the scale-out deployment.

확장 배포에서 보고서 서버 인스턴스를 제거하려면 설치 ID를 지정해야 합니다.Removing a report server instance from a scale-out deployment requires you to specify an installation ID. 설치 ID는 암호화 키를 제거하려는 보고서 서버 인스턴스의 RSReportserver.config 파일에 저장된 GUID입니다.The installation ID is a GUID stored in the RSReportserver.config file of the report server instance for which you want to remove encryption keys. 수평적 확장 배포에서 제거할 컴퓨터에서 다음 명령을 실행해야 합니다.You must run the following command on the computer that you want to remove from the scale-out deployment. 보고서 서버를 명명된 인스턴스로 설치한 경우 -i 인수를 사용하여 인스턴스를 지정합니다.If the report server is installed as a named instance, use the -i argument to specify the instance. 자세한 내용은 RsReportServer.config 구성 파일을 참조하세요.For more information, see RsReportServer.config Configuration File.

rskeymgmt -r <installationID>  

파일 위치File Location

Rskeymgmt.exe는 <* 드라이브>: files\microsoft SQL Server\110\Tools\Binn * * 또는 **< 드라이브*>: \Program 파일 (x86) \Microsoft SQL Server\110\Tools\Binn 합니다.Rskeymgmt.exe is located at <drive>:\Program Files\Microsoft SQL Server\110\Tools\Binn or at <drive>:\Program Files (x86)\Microsoft SQL Server\110\Tools\Binn. 파일 시스템의 모든 폴더에서 유틸리티를 실행할 수 있습니다.You can run the utility from any folder on your file system.

주의Remarks

보고서 서버는 저장된 자격 증명과 연결 정보를 암호화합니다.A report server encrypts stored credentials and connection information. 데이터를 암호화하는 데 공개 키와 대칭 키가 사용됩니다.A public key and a symmetric key are used to encrypt data. 보고서 서버를 실행하려면 보고서 서버 데이터베이스에 유효한 키가 있어야 합니다.A report server database must have valid keys in order for the report server to run. rskeymgmt 를 사용하여 키를 백업, 삭제 또는 복원할 수 있습니다.You can use rskeymgmt to back up, delete, or restore the keys. 키를 복원할 수 없을 경우 이 도구는 더 이상 사용할 수 없는 암호화된 내용을 삭제하는 방법을 제공합니다.If the keys cannot be restored, this tool provides a way to delete encrypted content that can no longer be used.

rskeymgmt 유틸리티를 사용하여 설치하는 동안 또는 초기화하는 동안 정의되는 키 집합을 관리할 수 있습니다.The rskeymgmt utility is used to manage the key set that is defined during Setup or during initialization. 이 유틸리티는 원격 프로시저 호출(RPC) 끝점을 통해 로컬 보고서 서버 Windows 서비스에 연결합니다.It connects to the local Report Server Windows service through a Remote Procedure Call (RPC) endpoint. 이 유틸리티가 올바르게 작동하려면 보고서 서버 Windows 서비스가 실행 중이어야 합니다.The Report Server Windows service must be running in order for this utility to work.

암호화 키에 대한 자세한 내용은 암호화 키 구성 및 관리(SSRS 구성 관리자)보고서 서버 초기화(SSRS 구성 관리자)를 참조하세요.For more information about the encryption keys, see Configure and Manage Encryption Keys (SSRS Configuration Manager) and Initialize a Report Server (SSRS Configuration Manager).

관련 항목:See Also

확장 배포 - Reporting Services 기본 모드(구성 관리자) Scale-out Deployment - Reporting Services Native mode (Configuration Manager)
Reporting Services 보고서 서버 ( 기본 모드 ) Reporting Services Report Server (Native Mode)
보고서 서버 명령 프롬프트 유틸리티 ( Ssrs) Report Server Command Prompt Utilities (SSRS)
구성 및 암호화 키 ( 관리 SSRS 구성 관리자 )Configure and Manage Encryption Keys (SSRS Configuration Manager)