REST-Schnittstelle

<< Klicken um Inhaltsverzeichnis aufzurufen >>

Navigation:  Komponenten > Authentifizierungsserver > Konfiguration > Einstellungen zum Tokenversand (self-hosted) >

REST-Schnittstelle

In diesem Kapitel erfahren Sie, wie Sie den Tokenversand über die REST-Schnittstelle konfigurieren können.

 

 

Für die Verwendung benötigen Sie ein System, welches auf REST-Anfragen reagiert.

 

Token sind notwendig für die Verwendung der Cordaware bestzero® Appsbox. Neben einem Versand des Tokens z. B. per E-Mail, ist es möglich einen POST-Request zu versenden.

 

Für die Einrichtung der REST-API-Schnittstelle und dem damit verbundenen POST-Request werden folgende Schritte benötigt:

 

hmtoggle_arrow11. best_local.ini (/best_srv/etc/)

 

 

[best_ext]
token_by_post = true (Default: false)

 

Dadurch kann im Script für den Tokenversand die folgende Funktion mit Rückgabewert verwendet werden. Der Wert ist hierbei "post".

 

 

best_script:user_token_sendby() -> post

 

Mit folgender Einstellung kann die Gültigkeitsdauer eines versendeten Tokens angepasst werden.

 

 

[best_ext]
token_by_post_lifetime = 30 (Default: 10)

 

In unserem Beispiel wurde die Gültigkeitsdauer auf 30 Tage erhöht. Normalerweise ist dieser nur 10 Tage gültig.

 

hmtoggle_arrow12. Info2Mail Filter (Weboberfläche)

 

Standardmäßig ist ein Script hinterlegt, der den Tokenversand über E-Mail gewährleistet. Das Script hierzu finden Sie im entsprechenden Kapitel.

Nachfolgend finden Sie eine kurze Anleitung, wo das Script zu finden ist und an welchen Stellen es angepasst werden muss.

 

1.Melden Sie sich an der Cordaware bestzero® Weboberfläche an.
 
bestzero_login
 

2. Öffnen Sie die Filter App in der Cordaware bestzero® Weboberfläche.

 

token-rest-api-1

 

 

3. Editieren Sie über die Taste E den bestzero token sending Filter.

 

token-rest-api-2

4. Ersetzen Sie nun das sichtbare Script mit diesem Script. Bitte beachten Sie, dass sie Ihre Serverdaten einfügen.

 

 

% Cordaware bestzero token mail script

-module(best_home_mail).

-export([main/1]).

 

%% Bitte setzen Sie hier den REST Server ein

bi_server() -> "https://myserver.cordaware.local/create_data".

bi_method() -> post.

 

%% Nachricht, welche über den JSON Parameter "msg" übergeben wird

bi_info(Token) ->

  <<"Guten Tag<br/><br/>\r\n",

  "Ihr Registrierungs-Token zur Eingabe in der Cordaware bestzero Appsbox lautet:<br/><br/><b> ", Token/binary, "</b><br/><br/>\r\n",

  "Wir wünschen viel Spaß<br/>\r\n",

  "Cordaware bestzero">>.

 

%% Ab hier bitte nichts mehr anpassen

 

main(_Doc) ->

  MailTo = [binary_to_list(best_script:user_email())],

  Token = best_script:user_token(),

  Info = bi_info(Token),

  %best_script:debug_msg("Sending bestzero Token to: ~p (token is ~p, timestamp is ~p)", [MailTo, Token, now()]),

  bi_letter(Info, Token)

  true.

 

bi_letter(Message, PostToken) ->

  Json = best_script:json_encode({[{<<"msg">>, Message},{<<"token">>, PostToken}]}),

  best_script:httprequest(bi_method(),

  {bi_server(), [],

    "application/json", Json

  }, [], []).

 

5. Abschließend speichern Sie bitte noch den Filter, um die Änderung festzuhalten. Ihre Benutzer werden nun einen Token per REST-Schnittstelle erhalten.

token-rest-api-3

 

 

Wenn Sie Unterstützung bei der Einrichtung des Tokenversands über die REST-Schnittstelle benötigen, steht Ihnen unser Support gerne zur Verfügung.

Melden Sie sich per E-Mail an support@cordaware.com, telefonisch unter der Telefonnummer +49 (0) 8441 8593 200 oder nutzen Sie unser Kundenportal.