1. ACLI Reference Guide
  2. ACLI Configuration Elements N-Z
  3. sti-server

sti-server

The sti-server object configures target servers the Oracle Communications Session Border Controller communicates with during STIR/SHAKEN processes.

Parameters

name
Specifies the name of this sti-server configuration. This name can be up to 128 characters and must not begin with a period (.) or a dash (-) character.
description
Specifies a brief description for this sti-server element.
state
Enables or disables the operational state of this sti-server configuration.
  • Default: enabled
  • Values: enabled | disabled
role
Identify the role of the STIR/SHAKEN server.
  • Default: BOTH
  • Values: STI-AS | STI-VS | BOTH
http-rest-type
The type of the STIR/SHAKEN implementation.
  • Default: ATIS
  • Values: 3GPP | ATIS
as-server-root
Specifies the IP Address or FQDN of the STIR verification server, with optional port and base path. Entry format is as a standard URL.
vs-server-root
Specifies the IP Address or FQDN of the STIR authentication server, with optional port and base path. Entry format is as a standard URL.
div-as-server-root
The STI-AS Server root URL for div authentication requests. This attribute accepts a hostname (starting with http:// or https://), an IPv4 address, or an IPv6 address. The port is optional.
div-vs-server-root
The STI-VS Server root URL for div verification requests. This attribute accepts a hostname (starting with http:// or https://), an IPv4 address, or an IPv6 address. The port is optional.
orig-id
This field specifies a UUID v4 to be added to STI-AS requests. Entry format is the standard UUID4 format, as in RFC 4122. You can enter a specific UUID or configure the system to generate a random UUID. The system generates a random UUID if you either:
  • Configure the parameter with consecutive quotes ("")
  • Configure the parameter with the All-Zero UUID in all interfaces (ACLI, REST, GUI): "00000000-0000-0000-0000-000000000000"
sti-attest
Specifies an attestation value that is sent in AS request. You must enter a value for this field to properly configure the sti-server.
  • A—Sets the parameter to full-attestation
  • B—Sets the parameter to partial-attestation
  • C—Sets the parameter to gateway-attestation
timeout
Specifies amount of time (in milliseconds) to wait for a REST response from a STIR server.
  • Default: 2000
  • Values: Valid Range: 100-30000
http-client
Specifies the name of a http-client configuration that has information for making connection to the sti-server. This name can be up to 128 characters and must not begin with a period (.) or a dash (-) character
max-burst-rate
Specifies the maximum sending burst rate for STIR requests (per second). Valid values are:
  • Default: 0
  • Values: Valid Range: 0-999999999
max-sustain-rate
Specifies the maximum sending sustained rate for STIR requests (per second). Valid values are:
  • Default: 0
  • Values: Valid Range: 0-999999999
burst-rate-window
Specifies the time period (in seconds) used to calculate burst rate. Valid values are:
  • Default: 0
  • Values: Valid Range: 0-999999999
sustain-rate-window
Specifies the time period (in seconds) used to calculate sustained rate. Valid values are:
  • Default: 0
  • Values: Valid Range: 0-999999999
options
Allows the configuration of applicable options to this sti-server.
sti-header-mapping-ruleset-name
Name of the STI ruleset you want to use for this sti-server. This ruleset takes precedence over any ruleset configured in the sti-config.
sti-response-treatment-config-name
Specifies the name of the sti-response-treatment-config to apply to this sti-server with which the system can attempt to match the contents of each received sti-vs response for the purpose of rejecting the associated call.
sti-reason-header-config-name
Specifies the sti-reason-header-config object you want to apply globally. This parameter takes the value of the applicable name parameter within a sti-reason-header-config object.
http-profile-name
Specifies the name of the http-profile object you want to apply to this sti-server to further refine access to that sti-server.

Path

sti-server is an element under the session-router branch. The full path from the topmost ACLI prompt is: configure terminal , and then session-router , and then sti-server.