Home
Configuring
Create a basic or an enterprise domain which is a single point for configuring and managing common resources, security, and instances.
Configuring security
Each Teracloud® Streams domain and instance maintains its own security configuration.
User authentication
The default user authentication method for Teracloud® Streams domains is PAM or LDAP. For a basic domain, Teracloud Streams uses PAM. For an enterprise domain, you can specify either LDAP or PAM as the default method when you create the domain, and then customize user authentication after the domain is created.
Customizing user authentication
When you create an enterprise domain, you must specify either LDAP or PAM as the default user authentication method for Teracloud® Streams. After creating the domain, you can use login modules and client certificates to customize user authentication.
Setting up login module authentication
Teracloud® Streams authenticates users by using a Java™ Authentication and Authorization Service (JAAS). You can use the login modules that are included in the product, or you can create your own to customize the security settings of your domain. Using login modules is optional.

Welcome
Learn about the core capabilities of Teracloud® Streams, its architecture, and key concepts.
Installing
Use this information to install, upgrade, and uninstall the Teracloud® Streams product.
Configuring
Create a basic or an enterprise domain which is a single point for configuring and managing common resources, security, and instances.
- Setting up a basic domain on a single resource
  A basic domain has a single Teracloud® Streams resource and user. This type of domain is typically used for test or development environments.
- Setting up an enterprise domain on multiple resources
  An enterprise domain can have multiple resources and users. This type of domain is typically used for production environments. You can configure high availability to ensure that Teracloud® Streams can continue to run even if resources fail or are not available.
- Configuring security
  Each Teracloud® Streams domain and instance maintains its own security configuration.
  - User authorization
    Teracloud® Streams uses access control lists (ACLs) to manage user authorization for domains and instances. An ACL contains the type of domain and instance objects to secure and the actions that a user or group is authorized to perform against the object. The ACLs are initialized when you create a domain or instance.
  - User authentication
    The default user authentication method for Teracloud® Streams domains is PAM or LDAP. For a basic domain, Teracloud Streams uses PAM. For an enterprise domain, you can specify either LDAP or PAM as the default method when you create the domain, and then customize user authentication after the domain is created.
    - Order of user authentication checks
      Your user authentication configuration determines how Teracloud® Streams authenticates users.
    - Customizing user authentication
      When you create an enterprise domain, you must specify either LDAP or PAM as the default user authentication method for Teracloud® Streams. After creating the domain, you can use login modules and client certificates to customize user authentication.
      - Setting up login module authentication
        Teracloud® Streams authenticates users by using a Java™ Authentication and Authorization Service (JAAS). You can use the login modules that are included in the product, or you can create your own to customize the security settings of your domain. Using login modules is optional.
        Teracloud® Streams login modules
        Teracloud® Streams provides built-in login modules for customizing PAM, LDAP, and X.509 certificate authentication.
        Developing user-defined login modules
        Use this procedure and the sample login module that is installed with Teracloud® Streams to develop your own customized login module.
        JAAS login configuration file example
        This example shows the format of the JAAS login configuration file and provides information about several file elements and attributes.
      - Setting up client certificate authentication
        Use this procedure to set up client certificate authentication for a Teracloud® Streams domain by using X.509 certificates. Using client certificate authentication is optional.
    - Generating authentication keys
      Use this procedure to generate public and private keys for Teracloud® Streams. Generating public and private keys eliminates the need for Teracloud Streams users to enter a password when they run streamtool commands.
    - Security session timeout property
      The security session timeout is the number of seconds before a Teracloud® Streams user session expires. This property setting is independent of the PAM or LDAP authentication service.
  - Linux users and Teracloud® Streams jobs
    To determine which Linux user has the authority to run the jobs for a Teracloud® Streams instance, you must first determine which user is running the domain controller services for your domain. The security implications of the instance.runAsUser and instance.canSetPeOSCapabilities property settings also need to be considered.
  - Changing the cryptographic protocol
    Many domain and instance services support connections that use Transport Layer Security (TLS) cryptographic protocols. You can specify which cryptographic protocols the services use for secure communication by setting domain and instance properties. Starting with Teracloud® Streams Version 7.2.0, the default protocol setting is TLSv1.3, which indicates that TLS 1.3 or later protocols are used.
  - Securing a Teracloud® Streams cluster
    While applications are deployed into production environments with specific recommendations that apply to individual customers, enterprise organizations generally have security policies and procedures that must be met and followed. To meet enterprise requirements, a combination of product and environment configuration is needed. The following are some key features using the standard information security CIA triad.
- Configuring audit logging
  Teracloud® Streams supports comprehensive, multiple-level auditing of product and user operations. By default, audit logging is not enabled.
- Configuring transport mechanisms
  Teracloud® Streams supports several high-performance and configurable transport mechanisms for communicating across processing elements (PEs). You can configure the transport mechanism by updating Teracloud Streams properties.
- Configuring a checkpoint data store
  Use this procedure to configure a checkpoint data store for Teracloud® Streams domains and instances.
Administering
Administer the product by using the Teracloud® Streams graphical user interface, APIs, or the streamtool command-line interface.
Developing
Learn about different Teracloud Streams tools and features to write, compile, run, and test streams applications.
Troubleshooting
Resolve problems with Teracloud® Streams using the troubleshooting tools provided with the product as well as the resources offered by Teracloud Support.
Reference
Find details on the SPL language, toolkits, APIs, commands, and more.
Glossary
Use this glossary to find terms and definitions for Teracloud® Streams.

Setting up login module authentication for Teracloud® Streams users

Teracloud® Streams authenticates users by using a Java™ Authentication and Authorization Service (JAAS). You can use the login modules that are included in the product, or you can create your own to customize the security settings of your domain. Using login modules is optional.

About this task

To customize user authentication, you can use the streamtool setloginconfig command.

Procedure

Customize user authentication by using the streamtool setloginconfig command. This command changes authentication configuration information for a domain. You must provide the information in a login configuration file.

You can use the following commands to obtain information about the login modules in a domain:

streamtool getloginconfig: This command retrieves authentication configuration information for each login module that is used by the domain. You can optionally output the information to a file.
streamtool lsloginmodule: This command lists the login modules that are installed for a domain.

For more information about these commands, enter streamtool man command-name.