Viewing & Modifying Account Information
To view (and modify) Account Information, click the Accounts menu. This is where you can set defaults for your account.
If you have sub-accounts (AKA child accounts for your primary account), you may see the following account selection screen, prior to the main Account Info page (If you don’t have sub-accounts, then you will go directly to your Account Details page):
Select the account you wish to view for the Accounts page, if you have sub-accounts for your business.
The Account Info page displays four sections:
- Account Information
- URL Authorization Configuration
- 2 Step URL Authorization Configuration
Of course, any default may be overridden through options in the API calls.
This page displays the following information about your account and your account settings. Let’s look at each of the sections, starting with the main Account Information section.
|Authentication 365 Account ID||Displays the internal Sinch Digital Interconnect Customer ID. (Not changeable)|
|HUB Account ID||Displays your Sinch Digital Interconnect A2P Hub account ID (Not changeable)|
|Operator ID||This is reserved for an interim, customer-specific solution.|
|Parent Account||Displays the account owner ID XXXXXX -- the entity that owns this account in case of hierarchy in the system
But, Company XYZ can have multiple sub-accounts (or child accounts).
|Client Name||The name of the account|
|Active Date||The date your account became active.|
|Account Description||A description of your account.|
|Default Message||This is the default message text that will be sent in the SMS to the subscriber the message text [token] will be replaced by the generated token.|
|Delivery Channel||Select the delivery mechanism: 1. Sinch Authentication 365 (SMS), 2. E-mail.
if you leave this field blank you can use your own delivery mechanism or channel – the token created will be returned to you in the API response.
|Expiration Date||Displays the account expiration date. This cannot be changed.|
|Branding Image||Image that will be display on the URL Authorization screen banner (and at the top right of your Authentication 365 UI pages). Click the Search button to search for your logo. Click Open to upload the logo.
Once you click the Update button at the bottom of the screen, you should see a small version of the image in the top right of the Authentication 365 UI pages.
Size limit is 300Kbytes (0.3Mbytes).
The Tokens & Callback Configuration section enable setting of default values for the validation token (type, length, timeout, number of retries as well as callback configurations for asynchronous URL Validations.
Token & Callback Configuration
|Token Type||You may generate either: 1. Numeric tokens 2. Alphanumeric tokens. Alphanumeric tokens are significantly more secure than numeric tokens.|
|Token Length||The length of the token you want to generate. The minimum token size is 4 characters. This is the default setting. The maximum is token size is 9 characters.|
|Token Timeout||Minimum is 30 seconds - Maximum is 30 days (expressed in seconds). If the user does not use and validate the token within on the specified Token Timeout period, then the token will expire.|
|Max Validation Retries||Allows you to specify the number of times you want to allow the user retry validation. 3 is the initial default.|
|Callback URL||This is only used if you are doing Asynchronous URL Validations: This is the registered callback URL that will be used for asynchronous URL validations.|
|Callback Authentication Type||This is only used if you are doing Asynchronous URL Validations: This will be Open (no signature secret) or Sign Key. To trust the source of the message you can configure a Signature Secret in the next field which is used to hash the body of the message with the “HMAC 256” algorithm and sent in the x-Sinch-di-signature header. For every received hash, you should rehash the body with the stored Secret to match the signature validation when the callback is received.|
|Callback Signed Key||This is only used if you are doing Asynchronous URL Validations: This is the secret key that will be used the hash the body of the message.|
The items in URL Authorization Configuration section provide defaults for the message body of a URL Validation, the success message, as well as the headline and sub-headline for the URL Authorization landing page. The Branding Image is set in the main Account Information section.
URL Authorization Configuration
|Message Body||Message text of the URL Authorization that appears in the SMS (or Email) message. You may use [link] to be replaced with the generated user-specific validation link.|
|Success Message||This is the text that will displayed to indicate the validation was successful. It appears on the URL Validation landing page – reached by the user tapping their user-specific validation link. This will appear below the brand image.|
|Headline||Headline text of the URL Authorization landing page.|
|Sub Headline||Sub Headline text of the URL Authorization landing page. (The brand image will appear below this text).|
The URL Validation (or Authorization) sequence is shown in the example below. Key fields are also highlighted.
The following are additional features that may be configured for the optional 2-step URL Authorization option.
Step URL Authorization Configuration
|Main Text||This text appears below the branding image when you are sending a 2-step URL validation (one that requires an affirmative or decline by the end-user, after they reach the URL Authorization landing page).|
|Affirmative Button Text||Text displayed on the Affirmative Button on the 2-Step URL Authorization landing page|
|Accept Message||Text of the Acceptance Message when the Affirmative button is tapped on the 2-Step URL Authorization landing page.|
|Decline Button Text||Text of the Decline Button of the 2 Step URL Authorization|
|Decline Message||Text of the Decline Message when the Decline button is tapped on the 2 Step URL Authorization landing page.|
|Button Color||Background color of the Accept and Decline Buttons of the 2 Step URL Authorization|
A 2-Step URL Authorization sequence is shown in example, below along with call-outs for the 2-step URL Authorization configuration fields. These are in addition to the fields configured in the URL Authorization Configuration section as outlined on the previous page.
After making any changes in any of the fields in any section, make sure that you click the Update button at the bottom of the screen.