Swisscom REST SMS Gateway
Please note: Only characters of the ISO 8859-1 charset can be used. Additionally, the charset that can be used depends on the settings of the Swisscom SMS Large Account.
serviceUri) accountId) systemId) password) sourceTon) Swisscom recommends the following setups:
- Source TON = 1 (International)
- Source NPI = 1 (ISDN)
- Swisscom Large Account source address in international format without '+' or '00' in front (e.g. 41791112233)
- Source TON = 5 (Alphanumeric number)
- Source NPI = 0 (Unknown)
- Swisscom Large Account source address as any text (e.g. Provider XY)
- Please be aware that most operators abroad of Switzerland are blocking messages with alphanumeric sender addresses
sourceNpi) Swisscom recommends the following setups:
- Source TON = 1 (International)
- Source NPI = 1 (ISDN)
- Swisscom Large Account source address in international format without '+' or '00' in front (e.g. 41791112233)
- Source TON = 5 (Alphanumeric number)
- Source NPI = 0 (Unknown)
- Swisscom Large Account source address as any text (e.g. Provider XY)
- Please be aware that most operators abroad of Switzerland are blocking messages with alphanumeric sender addresses
proxyHost) proxyPort) proxyLoginUser) proxyLoginPassword) allowOnlyTrustedCerts) Only allow connections to servers whose certificate is trusted. See documentation of property "Trust Store Path" for more information about what certificates are trusted.
Security warning: Trusting all certificates allows connections to adversarial hosts. Only disable this property for testing and integration setups.
verifyServerHostname) Enables hostname verification, i.e. the actual hostname must be the same as in the server certificate.
Security warning: Not verifying the hostname may allow connections to adversarial hosts, e.g. if they employ DNS spoofing. Only disable this property for testing and integration setups.
trustStorePath) If this property is not defined the following certificate issuers are trusted:
- The list of issuers known to the Java VM if the system property "javax.net.ssl.trustStore" is not defined.
- The list of issuers in a keystore referenced by system property "javax.net.ssl.trustStore" if defined in instance.properties using iam.java.opts
If this property is defined then the following certificate issuers are trusted:
- The list of issuers in the referenced truststore file and no others.
This property is only relevant if the property "Allow Only Trusted Certs" is enabled.
trustStoreType) trustStorePassword) Depending on the keystore type, leaving this property empty (or undefined) has a different effect:
- JKS: the keystore can be opened and used but the integrity of the keystore is not checked.
- PKCS12: an error occurs.
connectTimeout) correlationIdHeaderName) When configured, all requests sent contain a header with the correlation ID with the configured name. If no value or an empty value is specified, the correlation ID header is not sent.
If the correlation ID is not defined, the correlation ID header is not included in sent requests.
visiblePhoneNumberDigitsInLog) Defines the number of phone number digits visible in log statements.
Thus, if the value is zero, all digits are masked, if it is large enough, all digits are visible. If set to 3, for example, the logged number looks like ********965.
The default is 100, i.e. showing all digits.
type: SwisscomRestSmsGateway
id: SwisscomRestSmsGateway-xxxxxx
displayName:
comment:
properties:
accountId:
allowOnlyTrustedCerts: true
connectTimeout: 10
correlationIdHeaderName:
password:
proxyHost:
proxyLoginPassword:
proxyLoginUser:
proxyPort:
serviceUri:
sourceNpi: UNKNOWN
sourceTon: ALPHANUMERIC
systemId:
trustStorePassword:
trustStorePath:
trustStoreType: JKS
verifyServerHostname: true
visiblePhoneNumberDigitsInLog: 100