Jobnets webservices

Jobnet stiller HR-data (CV-data og jobannoncer ind og ud af Jobnet) til rådighed for eksterne brugere via webservices. Desuden udstiller Jobnet en række services til DFDG.

På denne side finder du dokumentation der er relevant for brugere af Jobnets webservices. 

Denne service udstiller en række metoder, der anvendes til at validere at virksomheden er kendt af Jobnet.

Serviceoversigt

Her finder du oversigt over Jobnets eksterne webservices: Udbyder_Jobnet 

Her finder du oversigt over Jobnets webservices til DFDG: Udbyder_JobnetInternDFDG 

Hvem kan bruge Jobnets eksterne webservices

Målgruppen for Jobnets eksterne services er primært job- og cv-banker samt virksomheder og organisationer med en vis volumen i antallet af annoncer, som ønskes importeret eller eksporteret fra Jobnet. 

Hvis du er ny bruger kan du læse mere om hvordan du kommer i gang på Arbejdsmarkedsstyrelsens hjemmeside Star.dk.

Jobnets eksterne webservices

Jobnets eksterne service arkitektur består af fire hovedområder: Job-In, Job-Out, CV-In og CV-Out, der står for henholdsvis import og eksport af Jobannoncer og CV-data

Samtlige af Jobnets webservices benytter sig af de åbne standarder SOAP og XML, og al Jobannonce- og import af CVR-information baserer sig på det internationale XML standardformat HR-XML.

SOAP

Jobnets webservices giver adgang til Jobnet systemets data via standard protokollen SOAP. En SOAP forespørgsel består af en såkaldt Envelope, der indeholder de parametrer, som skal bruges i forespørgslen til Jobnets webservices. Et SOAP svar består ligeledes af en Envelope, der indeholder svaret på forespørgslen i XML format i overensstemmelse med de associerede skemadefinitioner.

Adgang til Jobnets webservices foregår via https, som er beskrevet nærmere i afsnittet om sikkerhed. Der benyttes SOAP 1.2.

Skemaer

XML data der kommunikeres via Jobnets webservices defineres via et såkaldt XML schema. XML schemaet definerer de XML data, der sendes og modtages blandt andet i kraft af elementernes hierarkiske placering i XML dokumentet. XML står for eXensible Markup Language, og er kendetegnet ved en række egenskaber, som har gjort at netop XML er valgt til fælles offentlig standard - se W3C. Fordelen ved XML er at den fungerer uafhængig af den tekniske platform, og kan læses og forstås uanset hvilken teknologi man benytter.

WSDL

WSDL-filerne udgør en standardiseret beskrivelse af Jobnets webservices. WSDL beskriver metoder, beskedformat og protokoller, der er essentielle for at danne en proxy, der kan mægle i kommunikationen mellem klienten og webservicen.

Validering

Jobnet XSD filerne kan tilgås fra www.digitaliser.dk.

Sikkerhed

For at undgå at uønskede forespørgelser skal påvirke ydelsen af Jobnets webservices kræves det at der er indgået aftale med Arbejdsmarkedsstyrelsen for at få adgang til Jobnets webservices.

Jobnets webservices benytter sig af to metoder for at begrænse adgangen til deres webservices

• IP restriktion
• Autentikering og autorisation via brugernavn og password

Webservices der overfører sensitive data, som CV-Webservice accepterer kun forespørgelser over en sikker og krypteret forbindelse med SSL over port 443. Ligeledes anvender Job-In webservice sig af SSL for at sikre sig at brugernavn og password er krypteret.

Før en klient initierer en sikker forbindelse via SSL, verificerer denne serverens SSL certifikat, ved at undersøge om det er signeret af hvad der kaldes en CA (Certificate Authority), som f.eks Global sign eller Verisign. Jobnets SSL certificat er signeret af TDC CA der kan verificeres af Global Sign.

Job-Out webservice returnerer kun data der er offentlig tilgængelig på Jobnets Jobbank, og som derfor ikke behøver at være krypteret. Endvidere er autentifikationen af webservice brugerne kun baseret på klienternes IP adresser.

CV webservicen bruger en secure token authentication service til at hente, søge og indsætte et cv. Authentication servicen tager user credentials (username og password) som input og returnerer en token der indeholder information om user id, role, security level og expiration time.

Nedenfor vises et simple kode eksempel som opretter et user credentials og en token. Eksemplet er skrevet i C#.NET

public void SetUp()

AuthenticationService authenticationService = new AuthenticationService();

UserCredential userCredential = new UserCredential();
userCredential.Username = Username;
userCredential.Password = Password;
SecurityToken securityToken = new SecurityToken();
securityToken = authenticationService.RequestAuthentication(userCredential);

Webservice endpoints

Nedenfor links til jobnets eksterne webservices samt deres WSDL-filer:

Services til DFDG

xxx 

Jobreleaterede Jobin
JobOut
FindJob
CVRService


Generelle TaxonomyService


CV services AuthenticationService
CVService


Services til DFDG CVServiceForDFDG

CitizenAccountServiceForDFDG

JobOrderServiceForDFDG