Control Interface » History » Version 5
Moritz Horsch, 08/06/2012 01:03 PM
| 1 | 1 | Moritz Horsch | h1. Client Activation |
|---|---|---|---|
| 2 | |||
| 3 | h2. Interface |
||
| 4 | |||
| 5 | 4 | Moritz Horsch | | *URL* |\3. @http://127.0.0.1:24727/eID-Client@ | |
| 6 | 5 | Moritz Horsch | | *Description* |\3. The interface can be used to start the eID application. The parameters ifdName, contextHandle, and slotHandle address a particular eCard. If the parameters are absent, the eID application should ask the user to select an eCard if multiple cards are present. | |
| 7 | 4 | Moritz Horsch | | *Method* |\3. GET | |
| 8 | |/4. *Query* | tcTokenURL | The URL determines where the client can retrieve the TC Token. See TR-03112-7, section 3.2 | Mandatory | |
||
| 9 | 1 | Moritz Horsch | | ifdName | The ifdName determines the card terminal.| Optional; Not specified yet | |
| 10 | 5 | Moritz Horsch | | contextHandle | The contextHandle addresses a specific IFD. | Optional; Not specified yet | |
| 11 | 4 | Moritz Horsch | | slotHandle | The SlotHandle determines a connected eCard. See TR-03112-6, section 3.2.1. | Optional; Not specified yet | |
| 12 | 5 | Moritz Horsch | |/4. *Returns* | 200 OK |\2. The refresh address is comprised in the Message Body (Hack for Mac OS Safari). | |
| 13 | | 303 See Other |\2. The Location field in the response should contain the refresh address. | |
||
| 14 | | 400 Bad Request |\2. Malformed GET request, e.g. parameters are missing. | |
||
| 15 | | 500 Internal Server Error |\2. Other errors. | |
||
| 16 | |/2. *Content-Types* | text/plain |\2. All content should be encoded in text/plain or text/html. | |
||
| 17 | | text/html |\2. | |
||
| 18 | | *Notes* |\3. | |
||
| 19 | 1 | Moritz Horsch | |
| 20 | <pre> |
||
| 21 | 3 | Moritz Horsch | TODO |
| 22 | * What happens if the Client Activator cannot start an application? |
||
| 23 | 4 | Moritz Horsch | * What happens if the Client Activator cannot fetch a TC Token from the given TCTokenURL? Should that result in a 400 or 404? |
| 24 | 3 | Moritz Horsch | </pre> |
| 25 | 1 | Moritz Horsch | |
| 26 | 4 | Moritz Horsch | | *URL* |\2. @http://127.0.0.1:24727/status@ | |
| 27 | 5 | Moritz Horsch | | *Description* |\2. | |
| 28 | 3 | Moritz Horsch | | *Method* |\2. GET | |
| 29 | | *Query* | | | |
||
| 30 | |/4. *Returns* | 200 OK | | |
||
| 31 | 2 | Moritz Horsch | | 400 Bad Request | | |
| 32 | | 406 Not Acceptable | | |
||
| 33 | | 500 Internal Server Error | | |
||
| 34 | 4 | Moritz Horsch | |/3. *Content-Types* | text/html | Should be used for a HTML website with human readable content. | |
| 35 | | application/xml | Should be used to represent a ConnectionHandle in a machine readable XML format. | |
||
| 36 | | application/json | Same as XML but the data should encoded in a JSON format.| |