Verbinding maken met Power BI Report Server en SSRS vanuit mobiele Power BI-toepassingen
In dit artikel wordt beschreven hoe u uw omgeving configureert om OAuth-verificatie te ondersteunen met de mobiele Power BI-app om verbinding te maken met Power BI Report Server en SQL Server Reporting Services 2016 of hoger.
Eisen
Windows Server is vereist voor de WAP-servers (Web Application Proxy) en Active Directory Federation Services (AD FS). U hoeft geen domein op windows-functionaliteitsniveau te hebben.
Als u wilt dat gebruikers een rapportserververbinding kunnen toevoegen aan hun mobiele Power BI-app, moet u hen toegang verlenen tot de basismap van de rapportserver.
Notitie
Vanaf 1 maart 2025 kan de Power BI Mobile-app geen verbinding meer maken met Report Server met behulp van het OAuth-protocol via AD FS dat is geconfigureerd op Windows Server 2016. Klanten die OAuth gebruiken met AD FS die zijn geconfigureerd op Windows Server 2016 en Web Application Proxy (WAP), moeten hun AD FS-server upgraden naar Windows Server 2019 of hoger, of Microsoft Entra-toepassingsproxy gebruiken. Na de upgrade van Windows Server moeten gebruikers van de Power BI Mobile-app zich mogelijk opnieuw aanmelden bij Report Server.
Deze upgrade is vereist door een wijziging in de verificatiebibliotheek die wordt gebruikt door de mobiele app. De wijziging is op geen enkele manier van invloed op Microsoft-ondersteuning voor AD FS op Windows Server 2016, maar in plaats daarvan alleen de mogelijkheid van de Power BI Mobile-app om er verbinding mee te maken.
DNS-configuratie (Domain Name Services)
De openbare URL is de URL waarmee de mobiele Power BI-app verbinding maakt. Het ziet er bijvoorbeeld ongeveer als volgt uit.
https://reports.contoso.com
Uw DNS-record voor rapporteert aan het openbare IP-adres van de WAP-server (Web Application Proxy). U moet ook een openbare DNS-record configureren voor uw AD FS-server. U hebt bijvoorbeeld de AD FS-server geconfigureerd met de volgende URL.
https://fs.contoso.com
Uw DNS-record voor fs moet verwijzen naar het openbare IP-adres van de WAP-server (Web Application Proxy), aangezien het als onderdeel van de WAP-toepassing zal worden gepubliceerd.
Certificaten
U moet certificaten configureren voor zowel de WAP-toepassing als de AD FS-server. Beide certificaten moeten deel uitmaken van een geldige certificeringsinstantie die door uw mobiele apparaten wordt herkend.
Reporting Services-configuratie
Er is niet veel te configureren aan de zijde van Reporting Services. U hoeft alleen maar te controleren of:
- Er is een geldige SPN (Service Principal Name) om de juiste Kerberos-verificatie mogelijk te maken.
- De Reporting Services-server is ingeschakeld voor het onderhandelen over verificatie.
- Gebruikers hebben toegang tot de basismap van de rapportserver.
Serviceprincipalnaam (SPN)
De SPN is een unieke id voor een service die gebruikmaakt van Kerberos-verificatie. U moet ervoor zorgen dat u over een juiste HTTP SPN beschikt voor uw rapportserver.
Negotiate-authenticatie inschakelen
Als u wilt dat een rapportserver Kerberos-verificatie gebruikt, moet u het verificatietype van de rapportserver configureren als RSWindowsNegotiate. U doet dit in het rsreportserver.config-bestand.
<AuthenticationTypes>
<RSWindowsNegotiate />
<RSWindowsKerberos />
<RSWindowsNTLM />
</AuthenticationTypes>
Zie Een Reporting Services-configuratiebestand wijzigen en Windows-verificatie configureren op een rapportservervoor meer informatie.
Ad FS-configuratie (Active Directory Federation Services)
U moet AD FS configureren op een Windows-server in uw omgeving. De configuratie kan worden uitgevoerd via Serverbeheer en het selecteren van Functies en onderdelen toevoegen onder Beheren. Zie Active Directory Federation Servicesvoor meer informatie.
Belangrijk
Vanaf 1 maart 2025 kunnen de Mobiele Power BI-apps geen verbinding meer maken met Report Server via AD FS die zijn geconfigureerd op Windows Server 2016. Zie de opmerking aan het begin van dit artikel.
Een toepassingsgroep maken
In het scherm AD FS-beheer wilt u een toepassingsgroep maken voor Reporting Services die informatie bevat voor de mobiele Power BI-apps.
U kunt de toepassingsgroep maken met de volgende stappen.
Klik in de AD FS-beheer-app met de rechtermuisknop op toepassingsgroepen en selecteer toepassingsgroep toevoegen...
Geef in de wizard Toepassingsgroep Toevoegen een naam op voor de toepassingsgroep en selecteer native applicatie die toegang heeft tot een web-API.
Wizard
Selecteer Volgende.
Geef een naam op voor de toepassing die u aan het toevoegen bent.
Terwijl de Client-id automatisch wordt gegenereerd voor uw, voert u 484d54fc-b481-4eee-9505-0258a1913020 in voor zowel iOS als Android.
U wilt de volgende omleidings-URL's toevoegen:
Inzendingen voor Power BI Mobile - iOS:
msauth://code/mspbi-adal://com.microsoft.powerbimobile
msauth://code/mspbi-adalms://com.microsoft.powerbimobilems
mspbi-adal://com.microsoft.powerbimobile
mspbi-adalms://com.microsoft.powerbimobilemsAndroid-apps hebben alleen de volgende stappen nodig:
urn:ietf:wg:oauth:2.0:oobWizard 02
Selecteer Volgende.
Geef de URL voor uw rapportserver op. De URL is de externe URL die naar uw webtoepassingsproxy gaat. Deze moet de volgende indeling hebben.
Notitie
Deze URL is hoofdlettergevoelig.
https://<report server url>/reports
Selecteer Volgende.
Kies het Toegangsbeheerbeleid die past bij de behoeften van uw organisatie.
Kies Volgende.
Selecteer Volgende.
Selecteer Volgende.
Selecteer Sluit.
Wanneer dit is voltooid, ziet u de eigenschappen van uw toepassingsgroep er ongeveer als volgt uit.
Wizard
Voer nu de volgende PowerShell-opdracht uit op de AD FS-server om ervoor te zorgen dat het vernieuwen van tokens wordt ondersteund.
Set-AdfsApplicationPermission -TargetClientRoleIdentifier '484d54fc-b481-4eee-9505-0258a1913020' -AddScope 'openid'
Wap-configuratie (Web Application Proxy)
U wilt de Windows-rol Web Application Proxy (Role) inschakelen op een server in uw omgeving. Deze moet zich op een Windows-server bevinden. Zie Webtoepassingsproxy in Windows Server en Toepassingen publiceren met behulp van AD FS Pre-authenticatievoor meer informatie.
Configuratie van beperkte delegatie
Om over te stappen van OAuth-verificatie naar Windows-verificatie, moeten we beperkte delegering gebruiken met protocolovergang. Dit maakt deel uit van de Kerberos-configuratie. We hebben de Reporting Services SPN al gedefinieerd in de Reporting Services-configuratie.
We moeten beperkte delegering configureren voor het WAP Server-computeraccount in Active Directory. Mogelijk moet u met een domeinbeheerder werken als u geen rechten hebt voor Active Directory.
Als u beperkte delegering wilt configureren, moet u de volgende stappen uitvoeren.
Start op een computer waarop de Active Directory-hulpprogramma's zijn geïnstalleerd Active Directory Users and Computers.
Zoek het computeraccount voor uw WAP-server. Standaard bevindt deze zich in de computercontainer.
Klik met de rechtermuisknop op de WAP-server en ga naar Eigenschappen.
Selecteer het tabblad Delegering.
Selecteer Vertrouw deze computer alleen voor delegering naar specifieke services en vervolgens Gebruik elk verificatieprotocol.
Hiermee stelt u beperkte delegering in voor dit WAP Server-computeraccount. Vervolgens moeten we de services opgeven waaraan deze computer mag delegeren.
Selecteer Toevoegen... onder het vak Services.
Selecteer Gebruikers of Computers...
Voer het serviceaccount in dat u gebruikt voor Reporting Services. Dit account is het account waaraan u de SPN hebt toegevoegd binnen de Reporting Services-configuratie.
Selecteer de SPN voor Reporting Services en selecteer vervolgens OK.
Notitie
Mogelijk ziet u alleen de NetBIOS SPN. In feite worden zowel de NetBIOS- als FQDN-SPN's geselecteerd als ze beide bestaan.
Het resultaat moet er ongeveer als volgt uitzien wanneer het selectievakje Uitgevouwen is ingeschakeld.
Selecteer OK-.
WAP-toepassing toevoegen
Hoewel u toepassingen kunt publiceren in de console rapporttoegangsbeheer, willen we de toepassing maken via PowerShell. Hier volgt de opdracht om de toepassing toe te voegen.
Add-WebApplicationProxyApplication -Name "Contoso Reports" -ExternalPreauthentication ADFS -ExternalUrl https://reports.contoso.com/ -ExternalCertificateThumbprint "AA11BB22CC33DD44EE55FF66AA77BB88CC99DD00" -BackendServerUrl https://ContosoSSRS/ -ADFSRelyingPartyName "Reporting Services - Web API" -BackendServerAuthenticationSPN "http/ContosoSSRS.contoso.com" -UseOAuthAuthentication
Parameter | Opmerkingen |
---|---|
ADFSRelyingPartyName- | De web-API-naam die u hebt gemaakt als onderdeel van de toepassingsgroep in AD FS. |
ExternalCertificateThumbprint | Het certificaat dat moet worden gebruikt voor de externe gebruikers. Het is belangrijk dat het certificaat geldig is op mobiele apparaten en afkomstig is van een vertrouwde certificeringsinstantie. |
BackendServerUrl | De URL naar de rapportserver vanaf de WAP-server. Als de WAP-server zich in een DMZ bevindt, moet u mogelijk een volledig gekwalificeerde domeinnaam gebruiken. Zorg ervoor dat u deze URL kunt bereiken vanuit de webbrowser op de WAP-server. |
BackendServerAuthenticationSPN | De SPN die u hebt gemaakt als onderdeel van de Reporting Services-configuratie. |
Geïntegreerde verificatie instellen voor de WAP-toepassing
Nadat u de WAP-toepassing hebt toegevoegd, moet u de BackendServerAuthenticationMode instellen om IntegratedWindowsAuthentication te gebruiken. U hebt de id van de WAP-toepassing nodig om deze in te stellen.
Get-WebApplicationProxyApplication "Contoso Reports" | fl
Voer de volgende opdracht uit om de BackendServerAuthenticationMode in te stellen met behulp van de id van de WAP-toepassing.
Set-WebApplicationProxyApplication -id 00aa00aa-bb11-cc22-dd33-44ee44ee44ee -BackendServerAuthenticationMode IntegratedWindowsAuthentication
Verbinding maken met de mobiele Power BI-app
In de mobiele Power BI-app wilt u verbinding maken met uw Reporting Services-exemplaar. Hiervoor geeft u voor uw WAP-toepassing de externe URL op.
Wanneer u Connectselecteert, wordt u omgeleid naar de aanmeldingspagina van AD FS. Voer geldige referenties in voor uw domein.
Nadat u Aanmeldenhebt geselecteerd, ziet u de elementen van uw Reporting Services-server.
Meervoudige verificatie
U kunt meervoudige verificatie inschakelen om extra beveiliging voor uw omgeving in te schakelen. Zie Microsoft Entra multifactor authentication configureren als verificatieprovider met AD FSvoor meer informatie.
Problemen oplossen
U ontvangt de foutmelding 'Aanmelden bij SSRS-server is mislukt'
U kunt Fiddler instellen om te functioneren als een proxy voor uw mobiele apparaten om te zien hoe ver de aanvraag is gevorderd. Als u een Fiddler-proxy voor uw telefoonapparaat wilt inschakelen, moet u de CertMaker voor iOS- en Android- instellen op de computer waarop Fiddler wordt uitgevoerd. De invoegtoepassing komt van Telerik voor Fiddler.
Als de aanmelding werkt bij het gebruik van Fiddler, hebt u mogelijk een certificaatprobleem met de WAP-toepassing of de AD FS-server.
Verwante inhoud
- Een SPN (Service Principal Name) registreren voor een Report Server-
- een Reporting Services-configuratiebestand wijzigen
- Windows-verificatie configureren op een rapportserver
- Active Directory Federation Services
- Webtoepassingsproxy in Windows Server
- Toepassingen publiceren met AD FS-verificatie vooraf
-
Microsoft Entra-multifactorauthenticatie configureren als verificatieprovider voor AD FS
Meer vragen? Probeer de Power BI-community