자격 증명
데이터 원본 자격 증명은 여러 명령에서 캐시 및 재사용할 수 있습니다. 기본적으로, 이 캐시는 %LOCALAPPDATA%/Microsoft/pqtest 아래의 로컬 파일에 저장되며, 현재 사용자 키로
로컬 파일 스토리지 대신 Azure Key Vault자격 증명을 저장할 수 있습니다. --keyVault / -kv 옵션을 사용하여 키 자격 증명 모음 이름을 옵션 인수로 제공하고 다음 표에 지정된 환경 변수를 설정하여 이 옵션을 사용하도록 설정할 수 있습니다.
메모
Azure Key Vault를 사용하는 경우 자격 증명은 개별 비밀이 아닌 단일 이진 개체로 저장됩니다.
| 변수 | 세부 정보 | 견본 |
|---|---|---|
| PQTEST_AZURE_CLIENT_ID | 귀하의 키 자격 증명 모음에 대한 액세스를 허가 받은 Microsoft Entra ID 애플리케이션의 ID(GUID)입니다. | a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1 |
| PQTEST_AZURE_CLIENT_SECRET | Microsoft Entra ID 애플리케이션에 대한 클라이언트 암호입니다. | <클라이언트-비밀 자리 표시자> |
| PQTEST_AZURE_TENANT_ID | Azure Key Vault를 소유하는 테넌트에 대한 ID(GUID)입니다. | a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1 |
| PQTEST_AZURE_KEY_VAULT_URL | 키 볼트에 대한 URL입니다. | https://<myvault>.vault.azure.net |
keyVault 옵션 사용 예:
set PQTEST_AZURE_CLIENT_ID="a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1"
set PQTEST_AZURE_CLIENT_SECRET="<client-secret-placeholder>"
set PQTEST_AZURE_TENANT_ID="a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1"
set PQTEST_AZURE_KEY_VAULT_URL="https://myvault.vault.azure.net"
<Path to PQTest.exe>.\PQTest.exe list-credential --keyVault secretName
자격 증명 템플릿
이 명령을 사용하여 set-credential 명령에 전달할 수 있는 JSON 형식의 자격 증명 템플릿을 생성합니다. 명령어를 사용하려면 확장과 데이터 원본 정보을 제공해야 합니다. 데이터 원본이 둘 이상의 인증 종류를 지원하는 경우 --authenticationKind / -ak 옵션과 함께 사용할 인증 종류를 지정해야 합니다.
출력 템플릿에는 $$<키 이름>$$ 으로 식별된 자리 표시자 값이 있으며, 이는 set-credential 명령에 전달하기 전에 바꿔야 합니다.
예를 들어 MyConnector Anonymous 및 UsernamePassword 인증 종류를 모두 지원합니다.
Anonymous 자격 증명을 생성하기 위해 다음 명령을 사용합니다.
<Path to PQTest.exe>.\PQTest.exe credential-template --extension MyConnector.mez --queryFile MyConnectorQuery.m --prettyPrint --authenticationKind Anonymous
메모
출력 JSON 값에는 자리 표시자 값이 포함되지 않습니다. Anonymous 종류에는 자리 표시자 값이 필요하지 않습니다.
{
"AuthenticationKind": "Anonymous",
"AuthenticationProperties": {},
"PrivacySetting": "None",
"Permissions": []
}
다음 명령은 동일한 커넥터에 대한 UsernamePassword 자격 증명을 생성하는 데 사용됩니다.
<Path to PQTest.exe>.\PQTest.exe credential-template --extension MyConnector.mez --queryFile MyConnectorQuery.m --prettyPrint --authenticationKind UsernamePassword
결과 템플릿에는 자리 표시자 값 $$USERNAME$$ 및 $$PASSWORD$$이 포함됩니다.
{
"AuthenticationKind": "UsernamePassword",
"AuthenticationProperties": {
"Username": "$$USERNAME$$",
"Password": "$$PASSWORD$$"
},
"PrivacySetting": "None",
"Permissions": []
}
자격 증명 설정
이 명령을 사용하여 테스트 연결 및 실행 테스트 명령에 사용되는 자격 증명을 저장합니다. 이 명령을 사용하려면
- JSON 형식의 자격 증명 사용
- 추가 설정(
Anonymous및Windows)이 필요하지 않은 인증 종류의 자동 자격 증명입니다. - 대화형 모드 사용.
JSON 형식의 자격 증명
모든 자격 증명 종류는 JSON 자격 증명 형식을 사용하여 설정할 수 있습니다. 자격 증명 템플릿 명령 사용하여 자격 증명 JSON을 생성합니다.
JSON 템플릿을 사용하여 자격 증명을 설정할 때 입력은 명령에 파이프로 전달하거나 stdin에서 파일로 제공해야 합니다.
다음은 credential-template 명령의 결과를 set-credential에 파이핑하여 Anonymous 자격 증명을 설정하는 예제입니다.
<Path to PQTest.exe>.\PQTest.exe credential-template -e MyConnector.mez -q MyConnectorQuery.m -p -ak Anonymous | pqtest set-credential -e MyConnector.mez -q MyConnectorQuery.m -p
{
"Details": {
"Kind": "MyConnector",
"Path": "MyConnector",
"NormalizedPath": "MyConnector",
"IsDefaultForKind": false
},
"Message": "Successfully set credential",
"Status": "Success"
}
메모
자동 자격 증명사용하여 Anonymous 및 Windows 자격 증명을 설정할 수 있습니다.
다음은 디스크에 저장된 파일에서 자격 증명을 설정하는 예제입니다(리디렉션된 입력 사용).
<Path to PQTest.exe>.\PQTest.exe set-credential -e MyConnector.mez -q MyConnectorQuery.m -p < mySavedCredential.json
{
"Details": {
"Kind": "MyConnector",
"Path": "MyConnector",
"NormalizedPath": "MyConnector",
"IsDefaultForKind": false
},
"Message": "Successfully set credential",
"Status": "Success"
}
자동 인증
자격 증명 템플릿제공하지 않고 Anonymous 및 Windows 자격 증명을 설정할 수 있습니다.
메모
이러한 방식으로 설정된 Windows 자격 증명은 기본적으로 현재 사용자의 ID를 사용하는 것으로 설정됩니다.
자격 증명 템플릿 명령 사용하여 대체 Windows 계정 자격 증명을 사용하도록 수정할 수 있는 JSON 자격 증명을 생성합니다.
Windows 자격 증명을 생성하기 위해 다음 명령을 사용합니다.
<Path to PQTest.exe>.\PQTest.exe set-credential -e MyConnector.mez -q MyConnectorQuery.m -p --authenticationKind windows
Anonymous 자격 증명을 생성하기 위해 다음 명령을 사용합니다.
<Path to PQTest.exe>.\PQTest.exe set-credential -e MyConnector.mez -q MyConnectorQuery.m -p --authenticationKind anonymous
대화형 모드
--interactive 명령줄 옵션을 사용하여 대화형 모드를 사용하여 자격 증명을 설정할 수 있습니다.
대화형 모드는 OAuth 및 Aad 인증 종류에 사용할 수 있습니다. 이 모드에서 명령을 실행하면 OAuth 구현을 테스트하는 데 사용할 수 있는 OAuth 대화 상자가 표시됩니다.
대화형 OAuth 흐름은 별도로 설치해야 할 수 있는 WebView2(Microsoft Edge Chromium) 브라우저 구성 요소를 사용합니다.
자세한 내용은 Power BI Desktop대한
--useLegacyBrowser 옵션을 사용하여 IE11 포함된 브라우저 창을 강제 적용할 수 있습니다.