eH-I & ETEE.NeteHealth and .Net

Who Am I?: 1’ Who are you?: 1’ Introduction: 2’ eHealth: 7’ eH-I: 15’ ETEE.Net: 15’ License: 2’ Support: 3’

Topics

Who Am I? Who Are you? Introduction eHealth eH-I ETEE.Net License Support

Topics

Bryan Brouckaert Occupation:

◦ SOA Architect at Mensura◦ Coordinator of ETEE & eH-I projects on Codeplex

Experience:◦ .Net since 2002◦ Java since 2006◦ Web Services since 2003/2004

Contact: info@egelke.net

Who Am I?

Who Am I? Who Are you? Introduction eHealth eH-I ETEE.Net License Support

Topics

Raise hands if you know…1. .Net Framework2. VB.Net and/or C#3. Web Services4. Web Service Security5. Windows Communication Foundation (WCF)6. Java(EE)

Who Are you?

Who Am I? Who Are you? Introduction eHealth eH-I ETEE.Net License Support

Topics

eH-I◦ eHealth Interoperability, Security◦ WCF extensions for eHealth services clients◦ http://ehi.codeplex.com

ETEE.Net◦ End To End Encryption for .Net◦ Compatible with eHealth ETEE for Java◦ http://etee.codeplex.com

Introduction

Who Am I? Who Are you? Introduction eHealth eH-I ETEE.Net License Support

Topics

eH-I & ETEE.Net are NOT eHealth projects eH-I

◦ Client only, services remain 100% eHealth◦ For help on functionality/interface: eHealth◦ For help on .Net: Siemens/Community

ETEE.Net◦ .Net port of official eHealth ETEE library (Java)◦ eHealth remains responsible for specs◦ For all help: Siemens/Community

eHealth & eH-I/ETEE.Net

Open: No WS-Security Required Regular: Authenticate via Certificate Single Sign On

◦ Step 1: Get Saml-Ticket, using Authentication certificate Session certificate (HOK) Provided/Requested attributes

◦ Step n: Call web service, using Saml-Ticket Session certificate (HOK)

eHealth: Web Service, Security

eHealth: ETEE, known recip.

eHealth: ETEE, unknown recip.

Who Am I? Who Are you? Introduction eHealth eH-I ETEE.Net License Support

Topics

Library: WCF 4.0 Extensions Unit tests Examples

◦ STS◦ RN◦ Codage◦ …

Demo Tools

eH-I consists of

Where: in your own application,◦ .Net 4.0◦ WCF (not WSE)◦ eHealth (or related) web services clients

What: Configures WCF Clients to eHealth standards

How: Provide (custom) config sections Excludes: Service Clients (WSDL & Gen.

Code)

eH-I Library Usage

Shows eHealth Service (client) in action Example configuration(s)

◦ Via Code◦ Via Config

Includes◦ WSDL & XSD, eHealth remains owner!◦ Generated Client Code◦ Manual Client Code (where required)

eH-I Examples Usage

Demo (WIP)◦ Integrated example◦ Verify client machine, certificate, …

Unit Tests: internal Tools

◦ PKCS12: Split eHealth p12 file into 2 seperate files

eH-I (Other) Usage

Acquire library◦ Download “verified” assembly◦ Build own assembly from source code

Reference assembly in your project Add (eHealth) web service client(s)

◦ Add service reference in you project◦ Write web service client or copy it from samples

Provide required configuration

eH-I: Development

Acquire eHealth compatible certificate◦ eID certificate◦ eHealth issued Fedict certificate

For eHealth certificates◦ Import into Windows X509Store◦ Split p12 into 2 separate files

Reference certificate◦ X509Store: Via config or code◦ P12 file: via code

eH-I: Runtime

eH-I: Demo

Who Am I? Who Are you? Introduction eHealth eH-I ETEE.Net License Support

Topics

Core: Basic Function Set Unit Tests Library: Extended & Integrated Function Set Integration Tests Console Demo Samples

◦ VB◦ C#

ETEE.Net consists of

Where: In your own application,◦ .Net 2.0◦ Encrypts/Decrypts message (eHealth standard)

What: encryption/decryption/validation functions.

How: Calling methods Excludes:

◦ ETK & KGSS clients◦ Certificate validation (calls Windows instead)

ETEE.Net Core Usage

Depends on Core EndToEnd.cs: Examples of

◦ To known recipient◦ To known recipients◦ To unknown recipient(s)◦ To known and unknown recipients

Other: internal verification

ETEE.Net Tests Usage

Where: In you application,◦ .Net 4.0◦ Send/receive secure messages (eHealth Standard)

What: Functions, combining Core + ETK & KGSS client (uses eH-I).

How: Call methods, inherit class & Configure clients by providing (custom) config sections

Excludes: Some scenarios

ETEE.Net Library Usage

Depends on Library ServiceIntegrationTests.cs: Examples of

◦ Send known only◦ Send unknown and known◦ Receive known only◦ Receive unknown and known

Other: internal validation

ETEE.Net ITests Usage

Click Once Application◦ http://etee.codeplex.com/releases/clickonce/

“Real Life” example Verification of

◦ Client machine◦ Certificates◦ Received/Sent message◦ …

ETEE.Net Demo Usage

Used in SDK Doc

Core library contains SDK Doc◦ Xml format for Visual Studio integration◦ CHM format for sepearate usage

ETEE.Net Samples Usage

Using Core only, but not Library Acquire core

◦ Download “verified” assembly◦ Build assembly from source code

Reference core assembly in your project Get ETK & KGSS tokens in own way Call encrypt/decrypt/verify methods

ETEE.Net: Development (1)

Using Library Acquire core

◦ Download “verified” assembly◦ Build assembly from source code

Acquire library: Build assembly Reference both assemblies in your project Provide (custom) config for ETK & KGSS

client Write your own PostMaster class Call send/receive methods

ETEE.Net: Development (2)

Acquire eHealth Fedict issued certificate Repare eHealth certificate

◦ Import into Windows X509Store◦ Split p12 into 2 separate files

Reference certificate◦ X509Store: Via config or code◦ P12 file: via code

ETEE.Net: Runtime

ETEE.Net: Demo

Who Am I? Who Are you? Introduction eHealth eH-I ETEE.Net License Support

Topics

LGPLv3: Lesser General Public License v3 Guarantees: NONE Usage Restrictions on Assembly (dll)

◦ Verified build: none◦ Self build, no changes: none◦ Self build, modified: provide source + dep. to clients

Usage Restrictions on Code (and other) files◦ Unchanged: provide sources to client◦ Changed: Provide changed sources + dep. to client

Support your community, publish your extensions!

License

Who Am I? Who Are you? Introduction eHealth eH-I ETEE.Net License Support

Topics

SDK Documentation (ETEE.Net only) WIKI on Codeplex

◦ http://ehi.codeplex.com/documentation◦ http://etee.codeplex.com/documentation

Discussions on Codeplex◦ http://ehi.codeplex.com/discussions◦ http://etee.codeplex.com/discussions

Issues on Codplex Direct mail (only for private artifacts):

◦ info@egelke.net

Community Support