Home
MATRIXX Security
Network Security
Network zones are stacked with increasing proximity to the open internet or DMZ. Each zone is traversed by ingress and egress points through an application or server, with appropriate authentication and authorization for connecting system traffic.
RS Gateway Security
RS Gateway uses Spring Security to authenticate clients using login ID and password credentials.
URL Authorization
Out-of-the-box, RS Gateway supports Create, Read, Update, and Delete authentication (CRUD-based authorization) using CRUD-based permissions on the RS Gateway APIs.
Enable Authorization of Named Services
Perform these steps to restrict access to named REST services. Permissions apply to all URLs that implement the named services.

Welcome
MATRIXX Release Notes
MATRIXX Architecture
MATRIXX Installation and Upgrade
MATRIXX Configuration
MATRIXX Security
- About MATRIXX Security
- Introduction to MATRIXX Cloud Native Security
  The information in MATRIXX Security is best-practice information and identifies MATRIXX-specific security considerations and implementations. For container-specific and Kubernetes security information, see the third-party documentation.
- Cloud Native Security
  The information here addresses cloud native security and includes recommendations for securing your cloud native implementation.
- Managing Certificates
  MATRIXX uses certificates signed by a trusted certificate authority, or validated by other means, to establish secure communications with another party with the corresponding private key.
- Enabling Transport Layer Security
  Transport Layer Security (TLS) provides secure internet connections by encrypting data sent between a browser, a website, and the website server to ensure that data is transmitted privately.
- Network Security
  Network zones are stacked with increasing proximity to the open internet or DMZ. Each zone is traversed by ingress and egress points through an application or server, with appropriate authentication and authorization for connecting system traffic.
  - MATRIXX Gateway Proxy
    MATRIXX includes Gateway Proxy that acts as a secure entry point for all network traffic that is not the result of subscriber usage. It sits between external applications and the Traffic Routing Agent (TRA).
  - RS Gateway Security
    RS Gateway uses Spring Security to authenticate clients using login ID and password credentials.
    - RS Gateway Basic Authentication
      When RS Gateway is configured not to accept anonymous requests, clients must send a login request with a username and password.
    - OAuth 2.0 Authentication
      RS Gateway can authenticate clients (such as customer relationship management (CRM) software) with single sign-on using OAuth 2.0. The information here describes a generic implementation. For information about OAuth 2.0 and third-party identity and access management applications, see the discussion about OAuth 2.0 identity and access management.
    - URL Authorization
      Out-of-the-box, RS Gateway supports Create, Read, Update, and Delete authentication (CRUD-based authorization) using CRUD-based permissions on the RS Gateway APIs.
      - Enable Authorization of Named Services
        Perform these steps to restrict access to named REST services. Permissions apply to all URLs that implement the named services.
      - Enable URL Authorization for REST Handlers
        Edit the rsgateway_permissions.yaml file to customize access to OpenAPI3, JSON, or named REST services.
    - Add RS Gateway Users
      Unless anonymous access is enabled, all RS Gateway clients must be defined in rsgateway_users.yaml.
    - Configure Token Authentication
      You can configure customer-specific API keys to authenticate third-party applications with RS Gateway.
    - Configure RS Gateway for LDAP Authentication
      This example demonstrates a simple LDAP authentication for RS Gateway.
    - Use Kubernetes Secrets for RS Gateway TLS Certificates
      A TLS certificate can be retrieved from a Kubernetes secret and the certificate is automatically extracted, a keystore is generated, and the contents are added to the /sync/certs directory.
    - RS Gateway application.yaml Properties
      RS Gateway configuration is provided in YAML files.
    - RS Gateway Connection Properties
      You must configure RS Gateway to connect to the Gateway Proxy. Define these properties in a properties file (for example, rsgateway-site.yaml).
    - User Authentication and Password Management
      Use the /service/user service APIs to set, verify, and modify a user password.
  - Business API Gateway Security
    The Business API Gateway is a development framework that includes the Business API SDK, Rest Services Gateway (RS Gateway), Gateway Proxy, and application tier. It allows custom mobile applications, Web clients, and other custom implementations to integrate with MATRIXX.
  - SBA Gateway Security
    SBA Gateway supports TLS Mutual Authentication.
  - TMF Gateway Security
    TMF Gateway supports HTTP authentication through a configurable authorization URL.
  - TRA Security
    This section describes the general security configuration requirements for Traffic Routing Agent (TRA). These security requirements apply when virtual servers are defined and specified as secured.
  - Self-Signed Certificate Detection and Handling
    While self-signed certificates can be used in controlled environments such as internal testing, because they are not verified by a trusted certificate authority (CA) they must not be used in production environments. If the use of a self-signed certificate is intentional, such as for testing purposes, the MDC Gateway and Traffic Routing Agent (TRA) components include ways to override default handling.
  - Network Security Checklist
    The following is a list of best practices for network design and configuration.
- Application Security
  Application security includes configuring web applications and gateways.
- Database Security
  Depending on your MATRIXX environment, you can use multiple external databases.
- OAuth 2.0 Identity and Access Management
  MATRIXX supports third-party identity and access management application integration.
MATRIXX Integration
MATRIXX Diameter Integration
MATRIXX Call Control Framework Integration
MATRIXX TM Forum Integration
MATRIXX 5G Integration
MATRIXX 5G Event Streaming
MATRIXX Event Streaming
MATRIXX Administration
MATRIXX Web App Administration
MATRIXX Monitoring and Logging
MATRIXX Policy
MATRIXX Kafka CDR Consumer
MATRIXX Pricing and Rating
MATRIXX Pay Now
MATRIXX Subscriber Management
MATRIXX Subscriber Management API
MATRIXX Business API SDK
My MATRIXX Help
MATRIXX Backoffice Customer Tool Help
MATRIXX Third-Party Licenses
Glossary

Enable Authorization of Named Services

Perform these steps to restrict access to named REST services. Permissions apply to all URLs that implement the named services.

Procedure

Configure the rsgateway-extensions.yaml file with a ConfigMap in the Helm values file.
For example:
```
rsgateway:
  configuration:
    container:
      configmap:
        rsgateway-extensions.yaml: |-
           rest:
             subscriber_create_basic:
               roles: MTX_ROLE_CUST_ONE,MTX_ROLE_CUST_TWO
```
This enables calling of the subscriber_create_basic service by providing a user with role MTX_ROLE_CUST_ONE or MTX_ROLE_CUST_TWO permissions (required for calling the subscriber_create_basic service).

Configure the rsgateway_users.yaml file.

The configuration is:

username: "{EncodingAlgorithm}EncodedPassword, role1, role2, roleN"

where:

username — The client's login ID.
EncodingAlgorithm — The encoding algorithm (such as bcrypt).
EncodedPassword — An EncodingAlgorithm-encoded password string.
role(1, 2, N) — A comma-separated list of RS Gateway roles.

For example:

rsgateway:
  configuration:
    container:
      configmap:
        rsgateway_users.yaml: |-
          user:john: '{bcrypt}$2a$10$dXJ3SW6G7P50lGmMkkmwe.20cQQubK3.HZWzG3YB1tlRy.fqvM/BG, MTX_ROLE_RSG_CREATE, MTX_ROLE_RSG_READ, MTX_ROLE_RSG_UPDATE, MTX_ROLE_RSG_DELETE, MTX_ROLE_RSG_STD'

Apply the configuration and restart RS Gateway with a command like the following:
```
helm upgrade ag1 matrixx/matrixx --namespace matrixx-webapps-gateways -f matrixx-webapps-gateways_values.yaml --version 5270
```
Where matrixx-webapps-gateways_values.yaml is a Helm values file that defines the ConfigMaps and enables RS Gateway.

Results

The files are dynamically created and mounted to /sync/conf, which is synchronized with /opt/mtx/conf in the component container at start-up, using rsync.

What to do next

For a description of RS Gateway roles, see the related RS Gateway roles discussion. For information about supported encoding algorithms (such as bcrypt), see the discussion about password encoding in MATRIXX Security.

For more information about configuring MATRIXX gateways and web apps, including how to use configuration sources for configuration, see the discussion about configuring MATRIXX gateways and web apps in MATRIXX Configuration.