GLOBETEAM. Danmarks Miljøportal (DMP) Vejledning til fagsystemejere omkring tilkobling af.net-baseret web service. Version 1.2

Transkript

1 GLOBETEAM Danmarks Miljøportal (DMP) Vejledning til fagsystemejere omkring tilkobling af.net-baseret web service Version 1.2

2 Indledning Denne vejledning beskriver hvordan man claims-enabler en.net-baseret web service (WS) til brug med DMP's føderale brugerstyringsløsning ved brug af Microsoft Windows Identity Foundation (WIF). Vejledningen skal læses i konteksten af den overordnede vejledning "Vejledning til fagsystemejere omkring forløbet for tilkobling af en applikation". Vejledningen forudsætter at Microsoft Windows Identity Foundation (WIF) benyttes til claimsenabling af web service n. Denne vejledning er således ikke brugbar, såfremt man ønsker at anvende et andet API til claims-enabling af web services. Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 2 af 27

3 Indhold Indledning... 2 Indhold... 3 Forudsætninger for tilkobling af en.net-baseret web service... 4 WIF... 4.NET Framework 3.5 SP Certifikaterne er din største fejlkilde... 4 Tilkoblingen af en.net-baseret WS... 5 Sådan kobles WS'en op mod DMP... 6 Trin 1: Anskaffelse af det nødvendige certifikat... 6 Applikationens krypteringscertifikat... 6 Trin 2: Konfiguration af webapplikations web.config-fil... 6 Information omkring sikkerhedsrelateret logning... 6 Step-by-step eksempel på tilkoblingen af de.net-baserede samples... 7 Appendiks A. Tracing Appendiks B. Beskrivelse af WS'ens web.config-fil Appendiks C. Brug af ActAs til at kalde på vegne af en bruger Appendiks D. Web Services føderation - login mod organisationens lokale AD FS Appendiks E: Brugen af konfigurationsbaserede klienter til kald af web services på DMPs AD FS 2.0 uden brug af Windows Identity Foundation Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 3 af 27

4 Forudsætninger for tilkobling af en.net-baseret web service Såfremt de involverede.net-udviklere ikke allerede er fortrolige med claims og claims-enabling af web services på.net-platformen kan det anbefales at studere Microsofts onlinebog "A Guide to Claims based Identity and Access Control" fra Patterns & Practices-serien ( WIF Som nævnt i indledningen er vejledningen bygget på en forudsætning om at claims-enablingen sker ved brug af Windows Identity Foundation (WIF). WIF tager rent praktisk form af en hotfix og kan hentes på Download Center ( Der findes også en version af WIF til Windows 2003, der kan hentes på 810c-ea3c25b3969a&displaylang=en. WIF kan afvikles på Windows Server 2008 R2, Windows Server 2008 Service Pack 2, Windows 2003 SP2, Windows 7 og Windows Vista Service Pack 2. WIF til Windows 2008 forudsætter at der allerede er installeret IIS 7.0 og Microsoft.NET Framework 3.5 eller højere på platformen, mens WIF til Windows 2003 forudsætter at der er IIS 6.0 og Microsoft.NET Framework 3.5 eller højere på platformen. Det er et krav at WS'en er bygget i.net 3.5 SP1 samt IIS 7.0 (dog IIS 6.0 ved anvendelse af Windows Server 2003). Det er i øvrigt også et krav at web service'n er bygget i WCF. Både ASP.NET og WCF skal således være registreret i IIS..NET Framework 3.5 SP1 Det er et krav at anvende mindst.net Framework 3.5 SP1. Windows Identity Foundation kræver.net Framework 3.5 SP1. Certifikaterne er din største fejlkilde Når man ser bort fra deciderede kodefejl i selve WS'en og WS-klienten, så er brugen og konfigureringen af certifikater den absolut største kilde til fejl i forbindelse med claims-enabling af en løsning. Derfor anbefales det på det kraftigste at at udviklere såvel som infrastrukturfolk får "Appendix D: Digital Certificates" ( som pligtlæsning, idet langt størsteparten af de fejl og problemer, der forekommer i relation til claims-enabling, viser sig at udspringe i og omkring certifikaterne. Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 4 af 27

5 Tilkoblingen af en.net-baseret WS Sikkerheden for Web Services på DMPs AD FS 2.0-løsning er baseret på følgende standarder: - WS-Trust Message-baseret sikkerhed (dvs. HTTP-transport med message-baseret kryptering og signering) - SAML 1.1 eller SAML 2.0 tokens. Det skal aftales i forvejen med DMP, hvilken type tokens, der anvendes. - Der anvendes symmetriske nøgler til kryptering - Key size er Algorithm suite er Basic256 - Security Header Layout er Lax - Der kan autentificeres med AD FS en med User Name. Brugernavn og adgangskode skal mappe op mod en bruger oprettet i Danmarks Miljøportals administratorløsning - Der kan autentificeres mod AD FS en med x509. X509 certifikatet skal udstedes af DMP og mappe op mod en bruger oprettet i Danmarks Miljøportals administratorløsning - Der anvendes ikke service certificate negotiation mod AD FS 2.0 STS en - Der er frit valg om der anvendes service certificate negotation mod Web Services - Der er frit valg om der anvendes Secure Conversation mod Web Services. End points for DMP's STS er angivet nedenfor: User name authentication - (produktionsmiljø) - (testmiljø) X509 authentication MEX - (produktionsmiljø) - (testmiljø) - (produktionsmiljø) - (testmiljø) Bemærk at samples ne som udgangspunkt er bygget til brug med produktionssystemet. De vil dog naturligvis kunne tilpasses til at bruge testsystemet blot ved at udskifte URL erne (og evt. certifikater) på end points ne. Det anbefales så vidt muligt, at udviklerne tager udgangspunkt i de medfølgende samples, når der oprettes nye WS'er. De mange opsætningsmuligheder vil ellers hurtigt kunne risikere at gøre det til en uoverskuelig opgave at konfigurere alt det ovenstående i hånden. Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 5 af 27

6 Sådan kobles WS'en op mod DMP Der er kun en enkelt fysisk forudsætning for tilkoblingen af en.net-baseret web service. Der skal foreligge et X.509-certifikat fra en offentlig CA. Dette X.509-certifikat skal benyttes til encryption på WS'en. Hver enkelt web service, der kobles op mod DMPs AD FS 2.0 STS skal således være udstyret med et sådant unikt certifikat. Hvis der benyttes x509 til også at autentificere mod AD FS 2.0 kræver det dog tillige at der er udstedt et certifikat fra DMPs egen PKI. Trin 1: Anskaffelse af det nødvendige certifikat Der skal erhverves et certifikat til hver WS: Et certifikat til kryptering af beskeder mellem DMP og web servicen. Dette certifikat er ikke at forveksle med SSL certifikatet, idet certikatet benyttes til at gøre det muligt for STS'en at kryptere beskeder, som kun servicen kan læse. Som nævnt i den overordnede vejledning ("Vejledning til fagsystemejere omkring forløbet for tilkobling af en applikation") skal encryption certifikatet skal overleveres til DMP uden den private nøgle. Dvs. DMP skal have certifikatets public key-del. Applikationens krypteringscertifikat Krypteringscertfikatet skal erhverves hos en offentlig og anerkendt CA. Vi anbefaler især da de er godkendte i alle større browsere og er markant billigere end de store spillere såsom Verisign og Thawte. Vi anbefaler tilsvarende at dette erhverves som et almindeligt SSL-certifikat. Det skal som nævnt ikke bruges til SSL, men SSL-certifikaterne er generelt billigst, og de dækker de behov et certifikat skal opfylde for at kunne benyttes som krypteringscertifikat. Modsat et certifikat der benyttes til SSL-trafik, så skal dette certifikat ikke være udstedt til et bestemt common name. Common name er ligegyldigt for krypteringscertifikatet. Vi anbefaler dog stadig, at der vælges et sigende common name for certifikatet (f.eks. CN=<applikationsnavn>encryption.<organisationsnavn>.dk). Trin 2: Konfiguration af webapplikations web.config-fil Webapplikationens web.config-fil skal tilpasses på en række punkter før.net-applikationen fungerer efter hensigten. Appendiks B rummer en gennemgang af, hvor web.config-filen skal tilpasses. Information omkring sikkerhedsrelateret logning Claims er konsistente og valide repræsentationer af brugeren, der er logget ind via STS'en, som i vort tilfælde er DMP's føderale brugerstyring. Claims overføres til applikationen ved hjælp af sikre offentlige standarder, der garanterer for at overleveringen af claims til applikationen er sikker og pålidelig. Hvis applikationen benytter sig af sikkerhedsrelateret logning kan brugerens claims således fint benyttes i denne sammenhæng. Der er med andre ord ikke nogen forskel på logning i et føderalt scenarie relativt til et traditionelt brugerlogin. Det er dog naturligvis vitalt at man tilsikrer at logningen som minimum indbefatter de claims, der sikrer at der kan ske en entydig identifikation af Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 6 af 27

7 brugeren til et hvilke som helst senerekommende tidspunkt (dvs. logningen skal indbefatte en unik identifier såvel som de nødvendige informationer, der gør det muligt at finde tilbage til hvem denne unikke bruger var). Step-by-step eksempel på tilkoblingen af de.net-baserede samples Følgende step-by-step guide tager udgangspunkt i de medfølgende samples i solution en DmpAdfs2DotNetSamples.sln og beskriver, hvordan du får sample.net web servicen op at køre lokalt og får kaldt servicen via de medfølgende unit tests. Når disse trin er udført vil du have en kørende.net-baseret WS samt en unit test (dvs. i al praksis en minimal WS-klient), der rekvirerer et token fra DMPs AD FS 2.0 og påhæfter det et kald til WS'en. 1. Åbn solution en i Visual Studio Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 7 af 27

8 2. Certifikaterne dotnetsampleservice-encryption.dk.pfx, DMPSTStest client certificate.pfx (password: pw) og DMPSTStest client certificate (TEST).pfx (password: pw) installeres i Local Machine -> Personal. Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 8 af 27

9 3. Certifikaterne: servicecommunication.miljoeportal.dk.cer, tokensigning.miljoeportal.dk.cer, servicecommunication.test.miljoeportal.dk.cer og tokensigning.test.miljoeportal.dk.cer installeres i Local Machine -> Trusted People. Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 9 af 27

10 4. Certifikaterne DMP CA.cer og DMP CA (TEST).cer installeres i Local Computer -> Trusted Root Certification Authorities. Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 10 af 27

11 5. Oprettelse af en application pool i IIS 7 ved navn DMP AD FS 2.0 Samples. Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 11 af 27

12 6. Application pool ens bruger ændres til Network Service og Load User Profile sættes til True. Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 12 af 27

13 7. Der oprettes en applikation i IIS 7 ved navn dotnetsampleservice. Denne skal pege ned på mappen DotNetSamples.Service i de medfølgende samples. Applikationen tildeles den nyoprettede application pool DMP AD FS 2.0 Samples. Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 13 af 27

14 8. Network Service tildeles Read-rettighed til private key på dotnetsampleservice-encryption.dkcertifikatet (højreklik på certifikatet under Local Machine -> Personal og vælg All Tasks -> Manage Private Keys...). Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 14 af 27

15 9. Solution'en kompileres og de medfølgende.net unit tests for.net køres (bemærk, unit tests for.net er foldet ud på skærmbilledet). Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 15 af 27

16 Appendiks A. Tracing Tracing er et must have-værktøj, når man konfigurerer.net services baseret på WCF. Med tracing slået til på servicen vil du således meget hurtigere kunne opdage og fejlfinde en evt. fejlkonfiguration af servicen. Tracing tager form af en.e2e-fil. Du kan slå tracing til ved at indkommentere følgende sektion i Web.config på servicen: <!-- Enable this section to enable system.servicemodel diagnostics <diagnostics> <messagelogging maxmessagestolog="30000" logentiremessage="true" logmessagesatservicelevel="true" logmalformedmessages="true" logmessagesattransportlevel="true"> </messagelogging> </diagnostics> --> Og følgende sektion: <!-- Enable this section to enable full tracing <system.diagnostics> <sources> <source name="system.identitymodel" switchvalue="verbose" logknownpii="true"> <listeners> <add name="xml"/> </listeners> </source> <source name="system.servicemodel.messagelogging"> <listeners> <add name="xml"/> </listeners> </source> <source name="system.servicemodel" switchvalue="verbose, ActivityTracing" propagateactivity="true"> <listeners> <add name="xml"/> </listeners> </source> <source name="microsoft.identitymodel" switchvalue="verbose"> <listeners> <add name="xml"/> </listeners> </source> <source name="domstolene.jfs.brugerstyring" switchvalue="verbose"> <listeners> <add name="xml"/> </listeners> </source> </sources> <sharedlisteners> Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 16 af 27

17 <add name="xml" type="system.diagnostics.xmlwritertracelistener" initializedata="trace.e2e"/> </sharedlisteners> <trace autoflush="true"/> </system.diagnostics> --> Bemærk, at dette først fungerer, når application pool-brugeren er blevet tildelt Write-adgang til den mappe, som servicen kører i. Du kan fx åbne trace.e2e-filen i svctraceviewer.exe (som er tilgængelig på Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 17 af 27

18 Appendiks B. Beskrivelse af WS'ens web.config-fil Dette appendix indeholder en uddybning af indholdet af WS'ens web.config-fil. Bemærk at sektioner der ikke skal ændres for at bygge en ny service er udeladt af hensyn til overblikket. <?xml version="1.0"?> <configuration> <microsoft.identitymodel> <service savebootstraptokens="true"> <audienceuris> <!-- Den præcise URL servicen er registreret på --> <add value=" rvice.svc"/> </audienceuris> </microsoft.identitymodel> <system.servicemodel> <services> <service behaviorconfiguration="myservicebehavior" name="dotnetsamples.service.serviceimpl"> <endpoint address="" binding="ws2007federationhttpbinding" 1) Der angives, at servicen skal opbevare token et i hukommelsen når den kaldes, så det kan sendes videre til andre services via ActAs. Denne værdi kan udelades hvis servicen ikke laver act as 2) Der angives servicens præcise URL i audienceuris Her angives din services datakontrakt og entry point bindingconfiguration="myservicebinding" contract="dotnetsamples.common.contract.iservicecontract"> <identity> <dns value="dotnetsampleservice-encryption.dk"/> </identity> </endpoint> <endpoint address="mex" binding="mexhttpbinding" contract="imetadataexchange"/> </service> </services> <behaviors> <servicebehaviors> <behavior name="myservicebehavior"> Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 18 af 27

19 <servicecredentials> <!-- Identifikation af servicens encryption cert --> <servicecertificate storelocation="localmachine" storename="my" x509findtype="findbysubjectname" findvalue="dotnetsampleservice-encryption.dk"/> </servicecredentials> </behavior> </servicebehaviors> </behaviors> </system.servicemodel> Her angives servicens encryption certifikat. </configuration> Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 19 af 27

20 Appendiks C. Brug af ActAs til at kalde på vegne af en bruger ActAs-teknologien er en del af WS-Trust specifikation. ActAs gør det muligt at forespørge på et token til et servicekald, hvor man bruger et eksisterende token til at veksle til det nye token. Det primære scenarie for ActAs er, når: 1) En klient kalder service A med et token. 2) Service A ønsker at kalde en service B og bibeholde brugerens identitet mod service B. Service A kan dog ikke bruge det samme token, da dette er udstedt udelukkende til brug med service A. 3) Service A forespørger i stedet på et nyt token til service B, hvor token'et til Service A sendes med som ActAs Understøttelse af ActAs kræver først og fremmest, at DMP har åbnet op for at netop din service må lave ActAs samt angivet de services, den må bruge det overfor. Der skal altså laves en aftale med DMP om, at din service gerne må lave ActAs samt hvilke services, der gerne må udføres laves ActAs til. Når det er på plads er det blot nødvendigt at udføre en mindre ændring i koden, der laver forespørgslen for token et. Koden der snupper et token ser sådan her ud (pseudo): // Lav channel var channel = (WSTrustChannel) channelfactory.createchannel();... // Send request (RST) og modtag response (RSTR) var securitytoken = channel.issue(requestsecuritytoken); return securitytoken;... CloseChannel(channel); Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 20 af 27

21 For at requeste et token med ActAs bruges følgende samme kode med med den angivne mindre ændring: // Lav channel var channel = (WSTrustChannel) channelfactory. CreateChannelActingAs(securityTokenSomSkalBrugesTilActAs);... // Send request (RST) og modtag response (RSTR) var securitytoken = channel.issue(requestsecuritytoken); return securitytoken;... CloseChannel(channel); Forskellen er altså blot en enkelt kodelinje. Selve kaldet til servicen foregår præcis som var det et token forespurgt på almindelig vis. I samples ne er der tilføjet en operation på.net WS'en, der viser hvordan man får fat i det aktuelle token, der er sendt til servicen. Dette token har man altså "ved hånden", når der skal bruges ActAs: /// <summary> /// Operation der verificerer at bootstrap token'et er tilgængeligt /// </summary> public void AssertBootstrapTokenIsAvailable() { var identity = GetClaimsIdentity(); var token = identity.bootstraptoken; } if (token == null) throw new ApplicationException("Bootstrap token cannot be null"); Windows Identity Foundation husker som hovedregel ikke token et, så det kan tilgås i servicen som ovenfor. For at token'et skal være tilgængeligt skal der udføres følgende ændring i web.config-filen: <microsoft.identitymodel> <service savebootstraptokens="true">... </service> </microsoft.identitymodel> Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 21 af 27

22 Appendiks D. Web Services føderation - login mod organisationens lokale AD FS 2.0 Web services føderation omhandler i al sin enkelthed, at login et mod DMP sker med et token der er rekvireret hos en partnerorganisation frem for at der anvendes brugernavn/adgangskode eller x509 authentication direkte mod DMP. Den primære forudsætning for at bruge web services føderation, er at den kalder der anvender web servicen er logget på domænet i partnerorganisationens domæne. Et fødereret web services login består af følgende trin. 1) Klient henter lokalt token fra partnerorganisationens AD FS 2.0-server 2) Klient veksler det lokale token til et DMP token på DMPs AD FS 2.0 server 3) Klient kalder service med DMP token 4) Service svarer klient Afvigelsen ift. et direkte login mod DMP ligger således i punkt 1 og 2 hvor klienten bruger et lokalt token som kreditiver når DMP token et skal trækkes. I de medfølgende samples ligger der under unit tests en kodestump der kan hente et lokalt token fra en AD FS 2.0 server. Dette svarer altså til punkt 1 i ovenstående punktopstilling. public void TestCanGetLocalIdPToken() { // Indsæt adresse på lokal AD FS 2.0 // Bemærk, dette skal erstattes med din lokale AD FS 2.0 server // og denne AD FS 2.0 server skal have end pointet // "adfs/services/trust/13/windows" enablet var stsaddress = new EndpointAddress( new Uri(" EndpointIdentity.CreateDnsIdentity( " // Det end point på STS'en der modtager token'et fra den lokale IdP var dmpissuedtokenaddress = Constants.StsAddressIssuedToken; // Hent lokalt security token vha. Windows Authentication, // da vi er logget på domænet med den lokale IdP var localtoken = WsTrustClient.RequestSecurityTokenWithWindowsAuth( stsaddress, dmpissuedtokenaddress); } Assert.That(localToken, Is.Not.Null); Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 22 af 27

23 Med det lokale token i hånden kan klienten veksle token et til et DMP token (punkt 2), som vist her. Bemærk, at koden for at hente det lokale token er vist sammen med koden der veksler det til et DMP token for overblikkets skyld. public void TestCanExchangeLocalIdPTokenForToken() { // Indsæt adresse på lokal AD FS 2.0 var stsaddress = new EndpointAddress( new Uri(" EndpointIdentity.CreateDnsIdentity( " // Det end point på STS'en der modtager token'et fra den lokale IdP var dmpissuedtokenaddress = Constants.StsAddressIssuedToken; // Hent lokalt security token vha. Windows Authentication, // da vi er logget på domænet med den lokale IdP var localtoken = WsTrustClient.RequestSecurityTokenWithWindowsAuth( stsaddress, dmpissuedtokenaddress); // Udveksl token'et til et DMP token, som efterfølgende kan bruges til et // servicekald var securitytoken = WsTrustClient.RequestSecurityTokenWithIssuedTokenAuth( dmpissuedtokenaddress, Constants.ServiceAddress, stsaddress, localtoken, Constants.StsCertificate); } Assert.That(securityToken, Is.Not.Null); Med DMP token et i hånden kan klienten kalde en service på normal vis præcis som hvis token et var hentet via et direkte login mod DMP (punkt 3 og 4). // Kald service var result = TestCommon.TestCanCallServiceWithIssuedToken(securityToken); Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 23 af 27

24 Appendiks E: Brugen af konfigurationsbaserede klienter til kald af web services på DMPs AD FS 2.0 uden brug af Windows Identity Foundation Klienter der anvender Windows operativsystemerne tidligere end Windows Vista har ikke mulighed for at bruge Windows Identity Foundation-baseret klientkode og her må der anvendes traditionelle konfigurationsbaserede WCF-klientern. Denne sektion gennemgår hvordan disse klienter konfigureres og sample config klienten i sample-koden gennemgås. Selve klienten er placeret i projektet DotNetSamples.WcfClient, som er en del af de medfølgende samples til.net. Der anvendes en ren.config-baseret WCF klient som bruger ws2007httpbinding (til at hente tokens) og ws2007federationbinding (til at kalde services). Bindingen til servicen er kendetegnet ved at være en standard ws2007federationhttpbinding der peger på DMPs AD FS 2.0 STS via en ws2007httpbinding. Bemærk, at der både er en binding til TEST (vist nedenfor) og en binding til PROD. <binding name="servicebindingtest"> <reliablesession enabled="false" /> <security mode="message"> <message algorithmsuite="basic256" issuedkeytype="symmetrickey" issuedtokentype=" negotiateservicecredential="true"> <issuer address=" binding="ws2007httpbinding" bindingconfiguration="adfs20usernamebinding"> <identity> <dns value=" /> </identity> </issuer> <issuermetadata address=" /> </message> </security> </binding> Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 24 af 27

25 Bindingen til AD FS 2.0 er en standard ws2007httpbinding der anvender User Name authentication uden secure conversation og negotiation. <binding name="adfs20usernamebinding" maxreceivedmessagesize="65536"> <readerquotas maxdepth="32768" maxstringcontentlength="32768" maxarraylength="32768" maxbytesperread="32768" maxnametablecharcount="32768" /> <reliablesession enabled="false" /> <security mode="message"> <message clientcredentialtype="username" negotiateservicecredential="false" establishsecuritycontext="false" /> </security> </binding> Klientens konfiguration i.config-filen peger således på servicekontrakten for den konkrete sample service i samples ne samt binding en til services ws2007federationhttpbinding: <client> <endpoint address=" binding="ws2007federationhttpbinding" bindingconfiguration="servicebindingtest" contract="dotnetsampleservicens.iservicecontract"> <identity> <dns value="dotnetsampleservice-encryption.dk" /> </identity> </endpoint> </client> Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 25 af 27

26 Selve koden anvender først og fremmest WCF konfigurationen til at danne klienten til servicen: // Lav client var client = new DotNetSampleServiceNs.ServiceContractClient(); if (client.clientcredentials == null) throw new InvalidOperationException("ClientCredentials not present. Client is not correctly configured."); Derpå sættes brugernavn og adgangskode til servicen. Såfremt x509 authentication anvendes skal klientcertifikatet anvendes her. // Sæt credentials client.clientcredentials.username.username = UserName; client.clientcredentials.username.password = Password; Der indlæses Base-64 versioner af hhv. servicecommunication.miljoeportal.dk.cer (PROD) eller servicecommunication.test.miljoeportal.dk.cer (TEST) // Indlæs certifikat til hhv. AD FS 2.0 //var adfs20servicecertificate = LoadX509CertificateFromConfigFile("Adfs20ServiceCertificateBase64Prod"); var adfs20servicecertificate = LoadX509CertificateFromConfigFile("Adfs20ServiceCertificateBase64Test"); Servicens certifikat indlæses, hvor der i samples anvendes certifikatet til.net test servicen (dotnetsampleservice-encryption.dk.cer). // Indlæs certifikat til service var servicecertificate = LoadX509CertificateFromConfigFile("ServiceCertificateBase64"); Disse certifikater sættes på klienten: // Sæt public keys på hhv. AD FS 2.0 channel og Service channel da negotiation er slået fra client.clientcredentials.servicecertificate.scopedcertificates.add(adfs20userna meuri, adfs20servicecertificate); client.clientcredentials.servicecertificate.scopedcertificates.add(serviceuri, servicecertificate); Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 26 af 27

27 Certifikatvalidering deaktiveres da der anvendes selvsignerede certifikater til servicen i samples: // Deaktivering af certifikatvalidering på servicecertifikatet. Må IKKE være aktiveret i et produktionsmiljø, // da der her skal anvendes offentligt udstedte certifikater, som kan valideres client.clientcredentials.servicecertificate.authentication.certificatevalidatio nmode = X509CertificateValidationMode.None; client.clientcredentials.servicecertificate.authentication.revocationmode = X509RevocationMode.NoCheck; Hvis der kaldes Java services skal følgende linjer kommenteres ind for at slukke for secure conversation på klienten: // Indkommenter de næste to statements hvis der kaldes Java service, da disse ikke bruger secure conversation //var binding = (WS2007FederationHttpBinding)client.Endpoint.Binding; //client.endpoint.binding = CreateWsFederationBindingWithoutSecureConversation(binding); Derpå er det bare at kalde servicen: // Kald servicen var result = client.helloworld(new HelloWorldQuery { Text = "Jesper" }); // Udskriv svar Console.WriteLine(result.Text + ". Total claims received: " + result.claimscount); Globeteam A/S Virumgårdsvej 17A 2830 Virum Telefon Side 27 af 27