SSL 인증서 만들기Create an SSL certificate

이 문서에서는 Power BI 시각적 개체용 SSL(Secure Sockets Layer) 인증서를 생성하고 설치하는 방법을 설명합니다.This article describes how to generate and install Secure Sockets Layer (SSL) certificates for Power BI visuals.

Windows, macOS X 및 Linux 절차의 경우 Power BI 시각적 도구 .pbiviz 패키지가 설치되어 있어야 합니다.For the Windows, macOS X, and Linux procedures, you must have the Power BI Visual Tools pbiviz package installed. 자세한 내용은 Power BI 시각적 개체 개발을 위한 환경 설정을 참조하세요.For more information, see Set up your environment for developing a Power BI visual.

Windows에서 인증서 만들기Create a certificate on Windows

Windows 8 이상에서 PowerShell New-SelfSignedCertificate cmdlet을 사용하여 인증서를 생성하려면 다음 명령을 실행합니다.To generate a certificate by using the PowerShell cmdlet New-SelfSignedCertificate on Windows 8 and later, run the following command:

pbiviz --install-cert

Windows 7의 경우 pbiviz 도구를 사용하려면 명령줄에서 OpenSSL 유틸리티를 사용해야 합니다.For Windows 7, the pbiviz tool requires the OpenSSL utility to be available from the command line. OpenSSL을 설치하려면 OpenSSL 또는 OpenSSL Binaries로 이동합니다.To install OpenSSL, go to OpenSSL or OpenSSL Binaries.

인증서에 대한 자세한 내용 및 설치 지침은 Windows용 인증서 만들기 및 설치를 참조하세요.For more information and instructions for installing a certificate, see Create and install a certificate for Windows.

macOS X에서 인증서 만들기Create a certificate on macOS X

OpenSSL 유틸리티는 일반적으로 macOS X 운영 체제에서 사용할 수 있습니다.The OpenSSL utility is usually available in the macOS X operating system.

다음 명령 중 하나를 실행하여 OpenSSL 유틸리티를 설치할 수도 있습니다.You can also install the OpenSSL utility by running either of the following commands:

  • Brew 패키지 관리자를 사용하는 경우:From the Brew package manager:

    brew install openssl
    brew link openssl --force
    
  • MacPorts 를 사용하는 경우:By using MacPorts :

    sudo port install openssl
    

OpenSSL 유틸리티를 설치한 후 다음 명령을 실행하여 새 인증서를 생성합니다.After you install the OpenSSL utility, run the following command to generate a new certificate:

pbiviz --install-cert

자세한 내용 및 지침은 인증서 만들기 및 설치의 OSX 탭을 참조하세요.For more information and instructions, see the OSX tab in Create and install a certificate.

Linux에서 인증서 만들기Create a certificate on Linux

OpenSSL 유틸리티는 일반적으로 Linux 운영 체제에서 사용할 수 있습니다.The OpenSSL utility is usually available in the Linux operating system.

시작하기 전에 다음 명령을 실행하여 opensslcertutil이 설치되어 있는지 확인합니다.Before you begin, run the following commands to make sure openssl and certutil are installed:

which openssl
which certutil

opensslcertutil이 설치되지 않은 경우 openssllibnss3 유틸리티를 설치합니다.If openssl and certutil aren't installed, install the openssl and libnss3 utilities.

SSL 구성 파일 만들기Create the SSL configuration file

다음 텍스트를 포함하는 /tmp/openssl.cnf 라는 파일을 만듭니다.Create a file called /tmp/openssl.cnf that contains the following text:

authorityKeyIdentifier=keyid,issuer
basicConstraints=CA:FALSE
keyUsage = digitalSignature, nonRepudiation, keyEncipherment, dataEncipherment
subjectAltName = @alt_names

[ alt_names ]
DNS.1=localhost

루트 인증 기관 생성Generate root certificate authority

로컬 인증서에 서명하기 위한 루트 CA(인증 기관)를 생성하려면 다음 명령을 실행합니다.To generate root certificate authority (CA) to sign local certificates, run the following commands:

touch $HOME/.rnd
openssl req -x509 -nodes -new -sha256 -days 1024 -newkey rsa:2048 -keyout /tmp/local-root-ca.key -out /tmp/local-root-ca.pem -subj "/C=US/CN=Local Root CA/O=Local Root CA"
openssl x509 -outform pem -in /tmp/local-root-ca.pem -out /tmp/local-root-ca.crt

localhost용 인증서 생성Generate a certificate for localhost

생성된 CA 및 openssl.cnf 를 사용하여 localhost용 인증서를 생성하려면 다음 명령을 실행합니다.To generate a certificate for localhost using the generated CA and openssl.cnf , run the following commands:

PBIVIZ=`which pbiviz`
PBIVIZ=`dirname $PBIVIZ`
PBIVIZ="$PBIVIZ/../lib/node_modules/powerbi-visuals-tools/certs"
# Make sure that $PBIVIZ contains the correct certificate directory path. ls $PBIVIZ should list 'blank' file.
openssl req -new -nodes -newkey rsa:2048 -keyout $PBIVIZ/PowerBIVisualTest_private.key -out $PBIVIZ/PowerBIVisualTest.csr -subj "/C=US/O=PowerBI Visuals/CN=localhost"
openssl x509 -req -sha256 -days 1024 -in $PBIVIZ/PowerBIVisualTest.csr -CA /tmp/local-root-ca.pem -CAkey /tmp/local-root-ca.key -CAcreateserial -extfile /tmp/openssl.cnf -out $PBIVIZ/PowerBIVisualTest_public.crt

루트 인증서 추가Add root certificates

Chrome 브라우저의 데이터베이스에 루트 인증서를 추가하려면 다음을 실행합니다.To add a root certificate to the Chrome browser's database, run:

certutil -A -n "Local Root CA" -t "CT,C,C" -i /tmp/local-root-ca.pem -d sql:$HOME/.pki/nssdb

Mozilla Firefox 브라우저의 데이터베이스에 루트 인증서를 추가하려면 다음을 실행합니다.To add a root certificate to the Mozilla Firefox browser's database, run:

for certDB in $(find $HOME/.mozilla* -name "cert*.db")
do
certDir=$(dirname ${certDB});
certutil -A -n "Local Root CA" -t "CT,C,C" -i /tmp/local-root-ca.pem -d sql:${certDir}
done

시스템 수준 루트 인증서를 추가하려면 다음을 실행합니다.To add a system-wide root certificate, run:

sudo cp /tmp/local-root-ca.pem /usr/local/share/ca-certificates/
sudo update-ca-certificates

루트 인증서 제거Remove root certificates

루트 인증서를 제거하려면 다음을 실행합니다.To remove a root certificate, run:

sudo rm /usr/local/share/ca-certificates/local-root-ca.pem
sudo update-ca-certificates --fresh

수동으로 인증서 생성Generate a certificate manually

OpenSSL을 사용하여 수동으로 SSL 인증서를 생성할 수도 있습니다.You can also generate an SSL certificate manually using OpenSSL. 인증서를 생성하는 도구는 임의로 지정할 수 있습니다.You can specify any tools to generate your certificates.

OpenSSL 유틸리티를 이미 설치한 경우 다음을 실행하여 새 인증서를 생성합니다.If the OpenSSL utility is already installed, generate a new certificate by running:

openssl req -x509 -newkey rsa:4096 -keyout PowerBIVisualTest_private.key -out PowerBIVisualTest_public.crt -days 365

일반적으로 다음 명령 중 하나를 실행하여 PowerBI-visuals-tools 웹 서버 인증서를 찾을 수 있습니다.You can usually find the PowerBI-visuals-tools web server certificates by running one of the following commands:

  • 전역 도구 인스턴스의 경우:For the global instance of the tools:

    %appdata%\npm\node_modules\PowerBI-visuals-tools\certs
    
  • 로컬 도구 인스턴스의 경우:For the local instance of the tools:

    <Power BI visual project root>\node_modules\PowerBI-visuals-tools\certs
    

PEM 형식PEM format

PEM(Privacy Enhanced Mail) 인증서 형식을 사용하는 경우 인증서 파일을 PowerBIVisualTest_public.crt 로 저장하고 프라이빗 키를 PowerBIVisualTest_private.key 로 저장합니다.If you use the Privacy Enhanced Mail (PEM) certificate format, save the certificate file as PowerBIVisualTest_public.crt , and save the private key as PowerBIVisualTest_private.key .

PFX 형식PFX format

PFX(Personal Information Exchange) 인증서 형식을 사용하는 경우 인증서 파일을 PowerBIVisualTest_public.pfx 에 저장합니다.If you use the Personal Information Exchange (PFX) certificate format, save the certificate file as PowerBIVisualTest_public.pfx .

PFX 인증서 파일에 암호가 필요한 경우If your PFX certificate file requires a passphrase:

  1. 구성 파일에서 다음을 지정합니다.In the config file, specify:

    \PowerBI-visuals-tools\config.json
    
  2. server 섹션에서 <YOUR PASSPHRASE> 자리 표시자를 바꿔 암호를 지정합니다.In the server section, specify the passphrase by replacing the <YOUR PASSPHRASE> placeholder:

    "server":{
        "root":"webRoot",
        "assetsRoute":"/assets",
        "privateKey":"certs/PowerBIVisualTest_private.key",
        "certificate":"certs/PowerBIVisualTest_public.crt",
        "pfx":"certs/PowerBIVisualTest_public.pfx",
        "port":"8080",
        "passphrase":"<YOUR PASSPHRASE>"
    }
    

다음 단계Next steps