Udvikling: Sådan kobler du på DKJord webservicen

Denne trin-for-trin-guide forklarer, hvordan du kobler dig på DKJord webservice. Guiden er skrevet til integrationen med testbruger til demo servicen, hvilket er bedst at starte med, så du kan se, hvordan servicen agerer.

For at integrere med DKJord webservicen skal du gøre følgende:

1. Du skal have en brugerkonto på brugerstyring test med brugernavn og password, som har "miljoe_jordforurening_reg" rollen. Dette kan supporten hos Danmarks Miljøportal hjælpe med.
2. Dernæst skal du integrere op imod demo webservicen som kan findes i webservice oversigten: Webservices for Danmarks Miljøportal. Fra servicen kan du trække WSDL, som også er at finde i oversigten. Benyt WS4.
3. Derfra skal forbindelsen bygges op med service certifikat som er dkjord-demo cert. og  Adfs20ServiceCertificateBase64 som er login-test.

Få fat i DKjord demo certifikat og ADFSServicecertifikatet, fra Udvikling: Adgang til certifikater til DKJord Service

Miljøportalen udleverer ikke brugere i produktionsmiljøerne, som skal anvendes som test. Er din løsning klar og testet på demo, skal du henvende dig til organisationen og få en produktionsbruger. Herefter gøres samme øvelse, blot med produktions bruger, produktions service og produktionscertifikater.

Herunder ser du et eksempel på en .net metode, som laver et login:

 public static DKJordWSv4Client PerformUserLoginV4(string username, string password)
        {
            DKJordWSv4Client client;

            // Set the username and password
            client.ClientCredentials.UserName.UserName = username;
            client.ClientCredentials.UserName.Password = password;
            X509Certificate2 adfs20ServiceCertificate = new X509Certificate2();
            X509Certificate2 serviceCertificate = new X509Certificate2();

// Sets the certifcate to the login server
                adfs20ServiceCertificate = LoadX509CertificateFromConfigFile("Adfs20ServiceCertificateBase64");
                // the certificate used for DKjord
                serviceCertificate = LoadX509CertificateFromConfigFile("ServiceCertificateBase64");


            var binding = (WS2007FederationHttpBinding)client.Endpoint.Binding;
            var adfs20UserNameUri = binding.Security.Message.IssuerAddress.Uri;
            var serviceUri = client.Endpoint.Address.Uri;


            // Use public keys from the certificates as negotiation is not set.
            client.ClientCredentials.ServiceCertificate.ScopedCertificates.Add(adfs20UserNameUri, adfs20ServiceCertificate);
            client.ClientCredentials.ServiceCertificate.ScopedCertificates.Add(serviceUri, serviceCertificate);

            // Deactivtion of certificate validation
            //
            client.ClientCredentials.ServiceCertificate.Authentication.CertificateValidationMode = X509CertificateValidationMode.None;
            client.ClientCredentials.ServiceCertificate.Authentication.RevocationMode = X509RevocationMode.NoCheck;

            return client;
        }

Du bør orientere dig i artiklen: Udvikling – Kom godt i gang med Webservices. Denne artikel forklarer hvilke informationer du generelt bør være meget opmærksom på, ved arbejde op imod webservices fra Danmarks Miljøportal.