Web-Service API - Anmeldung und Zugangsverwaltung

Die Request<T> Klasse hat eine Eigenschaft "Ticket". Über diese wird die Authentifizierung an dem Web-Service übergeben.

Um ein neues Ticket zu erhalten, muss die Login Methode aufgerufen werden. An diese wird der Benutzername und das Passwort übergeben. Wenn die Anmeldung an c-entron erfolgreich war, erhält man ein Ticket zurück (eine zufallsgenerierte Zeichenfoleg). Über diese Zeichenfolge weiß der c-entron Web-Service um welchen Benutzer es sich handelt.

https://server.de/CentronService/REST/Login{    "Ticket": "",    "TrimResponse": 0,    "Data": {        "AppVersion": "1.0.0.0",        "Application": "{8A9E6F82-4DFF-4C93-916C-CEA90EE4ED22}",        "Device": "OfficeClient1",        "LoginKind": 0,        "Password": "Pa$$word!",        "Username": "CentronUser"    }}

Methoden für die Anmeldung / Verwaltung von Zugängen

Methode	Beschreibung
Login	Dies ist die wichtigste Methode im Web-Service. Über diese meldet sich der Benutzer an dem Web-Service an. Wenn die Anmeldung klappt, erhalten Sie ein Ticket zurück, welches Sie fortan bei allen Methoden beim Request Objekt angeben. Request: Username : c-entron Anmeldename Passwort: Passwort von dem Benutzer LoginKind : Gibt an um welche Anmeldeart es sich handelt.0 = c-entron Benutzer1 = Gezwungene Anmeldung übers AD. (in der Regel nicht notwendig. Wenn AD-Anmeldung in den Einstellungen aktiviert wurde, werden alle Anmeldungen mit der ID 0 automatisch auf 1 auf der Web-Service Seite gestellt.2 = Kundenzugang (Web-Account) Application : Hier die folgende Guid angeben: {8A9E6F82-4DFF-4C93-916C-CEA90EE4ED22} AddVersion : Hier können Sie die Version Ihrer Applikation übergeben (optional) Device : Hier können Sie das Gerät über welches sich angemeldet wird übergeben (optional)
Logout	Über diese Methode können Sie einen Benutzer (über das Ticket) vom Web-Service abmelden.
IsValidTicket	Diese Methode prüft ob das Ticket noch gültig ist.
CheckConnection	Diese Methode liefert einfach den Wert True zurück. Über diese kann geprüft werden ob eine Verbindung zum Web-Service aufgebaut werden kann. Diese Methode erfordert kein Ticket.
IsWebAccountAuthentification	Mit dieser Methode können Sie prüfen ob es sich bei dem Ticket um ein „Web-Account“ handelt (Kundenzugang).
GetAllConnectionTickets	Über diese Methode können Sie alle angemeldeten Benutzer auslesen.
RemoveConnectionTicket	Über diese Methode können Sie Benutzer vom Web-Service abmelden.
GetWebServiceSettings	Diese Methode liefert besondere Web-Service bezogene Einstellungen zurück.
SetWebServiceSettings	Diese Methode speichert die besonderen Web-Service bezogenen Einstellungen.
GetCommonLoginInformations	Diese Methode liefert Ihnen allgemeine Informationen zu dem angemeldeten Benutzer zurück. Unter anderem welche Rechte dieser im System hat.
IsUserAdmin	Gibt an ob der angemeldete Benutzer ein Administrator ist.