Skip to main content

JettyWebSocketServer

Description​

Implementation of WebSocketServerService. This service uses Jetty WebSocket server module to provide WebSocket session management throughout the application.

Tags​

Jetty, WebSocket, server

Properties​

In the list below required Properties are shown with an asterisk (*). Other properties are considered optional. The table also indicates any default values, and whether a property supports the NiFi Expression Language.

Display NameAPI NameDefault ValueAllowable ValuesDescription
Input Buffer Size *input-buffer-size4 kbThe size of the input (read from network layer) buffer size.
Max Text Message Size *max-text-message-size64 kbThe maximum size of a text message during parsing/generating.
Max Binary Message Size *max-binary-message-size64 kbThe maximum size of a binary message during parsing/generating.
Listen Port *listen-portThe port number on which this WebSocketServer listens to.

Supports Expression Language, using Environment variables.
SSL Context Servicessl-context-serviceController Service:
RestrictedSSLContextService

Implementations:
StandardRestrictedSSLContextService
The SSL Context Service to use in order to secure the server. If specified, the server will accept only WSS requests; otherwise, the server will accept only WS requests
SSL Client Authentication *client-authenticationNo Authentication
  • No Authentication
  • Want Authentication
  • Need Authentication
Specifies whether or not the Processor should authenticate client by its certificate. This value is ignored if the <SSL Context Service> Property is not specified or the SSL Context provided uses only a KeyStore and not a TrustStore.
Enable Basic Authentication *basic-authfalse
  • true
  • false
If enabled, client connection requests are authenticated with Basic authentication using the specified Login Provider.
Basic Authentication Path Specauth-path-spec/*Specify a Path Spec to apply Basic Authentication.

Supports Expression Language, using Environment variables.
Basic Authentication Rolesauth-roles**The authenticated user must have one of specified role. Multiple roles can be set as comma separated string. '*' represents any role and so does '**' any role including no role.

Supports Expression Language, using Environment variables.
Login Servicelogin-serviceHashLoginService
  • HashLoginService
Specify which Login Service to use for Basic Authentication.
Users Properties Fileusers-properties-fileSpecify a property file containing users for Basic Authentication using HashLoginService. See http://www.eclipse.org/jetty/documentation/current/configuring-security.html for detail.

Supports Expression Language, using Environment variables.

State Management​

This component does not store state.

Restricted​

This component is not restricted.

System Resource Considerations​

This component does not specify system resource considerations.

See Also​