nscale Server Application Layer

Diese Seite beschreibt einige Funktionen des Application Layers.

Dokumentation

Technische Dokumentation Application Layer:

NQL Dokumentation, die nscale Abfragesprache. Alternativ als PDF
Plugin FAQ, die Application Layer Plugins FAQ Dokumentation
AL-CmdClient, das Application Layer Kommandozeilen Tool. Alternativ als PDF

REST

Der Application Layer bietet einige seiner Daten und Services auch über eine REST Schnittstelle als Web-Ressource an. Als Datenrepräsentationen werden XML und JSON unterstützt. HTML und Text werden teilweise als lesbare Repräsentation angeboten.

REST Dokumentation, ein Überblick der REST Schnittstelle. Alternativ als PDF
REST API Referenz, die API Referenz Dokumentation der REST Schnittstelle
WADL Dokument, die WADL Dokumentation der REST Schnittstelle
XML Schema Datei, das Schema der Daten der XML Repräsentation

GraphQL

Der Application Layer bietet fast alle seiner Daten und Services auch über eine GraphQL Schnittstelle als Web-Ressource an. Als Datenrepräsentation wird JSON unterstützt. Mit GraphQL werden zwei Tools zur Verfügung gestellt, nämlich GraphQL-Playground und Voyager. GraphQL-Playground dient als interaktive IDE, womit Queries live getestet werden können und das Schema angezeigt werden kann. Mit Voyager kann das vollständige GraphQL-Schema grafisch dargestellt werden.

GraphQL Dokumentation, ein Überblick der GraphQL Schnittstelle. Alternativ als PDF
GraphQL Schema, das Schema von GraphQL für NAPPL
GraphQL Playground, die GraphQL IDE für bessere Entwicklungs-Workflows
GraphQL Voyager, die grafische Darstellung von GraphQL-Schema

Anmeldung

Der Zugriff auf Web-Ressourcen vom nscale Application Layer Server erfordert eine HTTP Authentifizierung. Je nach Server Plattform bzw. Clients gibt es einige Hinweise. Es gibt folgende HTTP Authentifizierungen:

Negotiate (Kerberos oder NTMLv2)
NTLM
Basic

Bei der Verwendung von SSL sollte das Server Zertifikat in den Client Zertifikatsspeicher geladen werden. Hier ist das Application-Layer Zertifikat als Download .

Für eine eigene CA müssen Sie einen CSR stellen (Certificate Signing Request):
keytool -certreq -file newreq.pem -keystore certificates.store -alias applicationlayer -ext san=dns:fully-qualified-hostname

Signieren der Datei 'newreq.pem' (z.B. mit http://active-directory/certsrv) und importieren der Antwort:
keytool -import -trustcacerts -keystore certificates.store -alias applicationlayer -file "certnew.p7b"

Application Layer Instanzen

Hier gelangen Sie zu den Application Layer REST basierten Instanzen.