Verwerking Power Query van connectors
In Power BI wordt het laden van aangepaste connectors beperkt door de beveiligingsinstelling van uw keuze. Als de beveiliging voor het laden van aangepaste connectors is ingesteld op Aanbevolen, worden de aangepaste connectors over het algemeen helemaal niet geladen en moet u deze verlagen om ze te laden.
De uitzondering hierop is vertrouwde, 'ondertekende connectors'. Ondertekende connectors zijn een speciale indeling van aangepaste connectors, een PQX-bestand in plaats van een MEZ-bestand, dat is ondertekend met een certificaat. De gebruiker of de IT-afdeling van de gebruiker kan een vingerafdruk van de handtekening verstrekken, die in het register kan worden opgenomen om veilig aan te geven dat een bepaalde connector wordt vertrouwd.
Met de volgende stappen kunt u een certificaat gebruiken (met uitleg over het genereren van een certificaat als u er nog geen hebt) en een aangepaste connector ondertekenen met het hulpprogramma MakePQX.
Notitie
Als u hulp nodig hebt bij het maken van een zelfondertekend certificaat om deze instructies te testen, gaat u naar de Microsoft-documentatie over New-SelfSignedCertificate in PowerShell.
Notitie
Als u hulp nodig hebt bij het exporteren van uw certificaat als pfx, gaat u naar Export-PfxCertificate.
Download MakePQX.
Extraheer de MakePQX-map in het meegeleverde zip-bestand naar het beoogde doel.
Als u deze wilt uitvoeren, roept u MakePQX aan in de opdrachtregel. Hiervoor zijn de andere bibliotheken in de map vereist, zodat u niet alleen het uitvoerbare bestand kunt kopiëren. Als u zonder parameters wordt uitgevoerd, wordt de Help-informatie retourneren.
Gebruik: MakePQX [opties] [opdracht]
Opties:
| Opties | Description |
|---|---|
| -? |-h | --help | Help-informatie tonen |
Opdrachten:
| Opdracht | Beschrijving |
|---|---|
| Pack | Maak een pqx-bestand. |
| Teken | Ondertekent een niet-ondertekende pqx of tellers als pqx al is ondertekend. Gebruik de optie --replace om de bestaande handtekening te vervangen. |
| Controleren | Controleer de handtekeningstatus van een pqx-bestand. De retourwaarde is niet nul als de handtekening ongeldig is. |
MakePQX heeft drie opdrachten. Gebruik MakePQX [opdracht] --help voor meer informatie over een opdracht.
Pack
Met de opdracht Pack wordt een mez-bestand ingepakt in een pqx-bestand, dat kan worden ondertekend. Het pqx-bestand biedt ook ondersteuning voor een aantal mogelijkheden die in de toekomst worden toegevoegd.
Gebruik: Opties voor [ MakePQX-pack ]
Opties:
| Optie | Beschrijving |
|---|---|
| -? |-h | --help | Help-informatie tonen. |
| -mz | --mez | Invoerextensiebestand. |
| -c | --certificate | Certificaat (.pfx) dat wordt gebruikt om het extensiebestand te ondertekenen. |
| -p | --password | Wachtwoord voor het certificaatbestand. |
| -t | --target | Naam van uitvoerbestand. De standaardwaarde is dezelfde naam als het invoerbestand. |
Voorbeeld
C:\Users\cpope\Downloads\MakePQX>MakePQX.exe pack -mz "C:\Users\cpope\OneDrive\Documents\Power BI Desktop\Custom Connectors\HelloWorld.mez" -t "C:\Users\cpope\OneDrive\Documents\Power BI Desktop\Custom Connectors\HelloWorldSigned.pqx"
Teken
Met de opdracht Ondertekenen ondertekent u uw pqx-bestand met een certificaat, waardoor het een vingerafdruk krijgt die kan worden gecontroleerd op vertrouwen door Power BI clients met de hogere beveiligingsinstelling. Deze opdracht neemt een pqx-bestand en retourneert hetzelfde pqx-bestand, ondertekend.
Gebruik: Opties voor [ MakePQX-tekenargumenten ] [ ]
Argumenten:
| Argument | Description |
|---|---|
| <pqx file> | Het pad naar het pqx-bestand. |
Opties:
| Optie | Beschrijving |
|---|---|
| -c | --certificate | Certificaat (.pfx) dat wordt gebruikt om het extensiebestand te ondertekenen. |
| -p | --password | Wachtwoord voor het certificaatbestand. |
| -r | --replace | Vervang bestaande handtekening in plaats van tegentekenen. |
| -? |-h | --help | Help-informatie tonen. |
Voorbeeld
C:\Users\cpope\Downloads\MakePQX>MakePQX sign "C:\Users\cpope\OneDrive\Documents\Power BI Desktop\Custom Connectors\HelloWorldSigned.pqx" --certificate ContosoTestCertificate.pfx --password password
Verifiëren
Met de opdracht Verifiëren wordt gecontroleerd of de module correct is ondertekend en wordt de certificaatstatus weergegeven.
Gebruik: Opties voor [ makePQX-verificatieargumenten ] [ ]
Argumenten:
| Argument | Description |
|---|---|
| <pqx file> | Het pad naar het pqx-bestand. |
Opties:
| Optie | Beschrijving |
|---|---|
| -q | --quiet | De uitvoer van handtekeningverificatie wordt verborgen. |
| -? |-h | --help | Help-informatie tonen. |
Voorbeeld
C:\Users\cpope\Downloads\MakePQX>MakePQX verify "C:\Users\cpope\OneDrive\Documents\Power BI Desktop\Custom Connectors\HelloWorldSigned.pqx"
{
"SignatureStatus": "Success",
"CertificateStatus": [
{
"Issuer": "CN=Colin Popell",
"Thumbprint": "16AF59E4BE5384CD860E230ED4AED474C2A3BC69",
"Subject": "CN=Colin Popell",
"NotBefore": "2019-02-14T22:47:42-08:00",
"NotAfter": "2020-02-14T23:07:42-08:00",
"Valid": false,
"Parent": null,
"Status": "UntrustedRoot"
}
]
}
Ondertekende connectors vertrouwen in Power BI Desktop
Nadat u uw handtekening hebt geverifieerd, kunt u de vingerafdruk aan de eindgebruiker verstrekken om als vertrouwd te worden weergegeven. Meer informatie over het verstrekken van de vingerafdruk vindt u in Power BI documentatie.