Create a Self-Registration Profile

External utility customers can create their own web login to Digital Self Service - Transactions by completing the Self-Registration Profile. To enable this, you must create a self-registration profile for users to enter their information.

Once they have activated their account by validating their email address, they can link their web login with their utility account through the Digital Self Service - Transactions portal. If you use groups as part of your user access implementation, this profile automatically assigns the user to the DSSUserGroup.

To create a self-registration page for external users:
  1. Navigate to your domain in the Oracle Cloud Infrastructure Identity and Access Management Admin Console.
  2. Select Settings, then select Self Registration, and then select Add profile.
  3. Specify the following information, which are the only configurations supported by Digital Self Service - Transactions:
    • Profile Name: DSS_Production_Self_Registration_Profile
    • User Consent required: Ensure this checkbox is cleared.
    • Assign to Group: DSSUserGroup
      This setting is only required if you use groups as part of your user access implementation.
    • Allow Email Domains: all
  4. Under Self-Registration Content, provide a name in Registration Page Name such as Production_Self_Registration. This name is internal only and is not shown to customers.
  5. Click Add profile.
  6. Select the self-registration profile you just created, and from the menu on the right-hand side select the Activate option.
  7. Re-open the profile and make note of the profile ID that is generated. You will provide this to your delivery team to complete the integration.

After you create the self-registration profile, you can access it using the profile ID that was generated for the new profile.

Note: Your customers will interact with the Digital Self Service - Transactions registration screen, not Oracle Cloud Infrastructure Identity and Access Management.

Back to Top

Supporting Notifications for Pre-authenticated Customers in Preferred Language

If you plan to send notifications to pre-authenticated customers that reflect their preferred language, additional configuration for the self-registration portal is required.

To support notifications for pre-authenticated customers in their preferred language
  1. To update the self-registration profile, a REST API must be used. Refer to IAM Identity Domains API for information on how to use the applicable REST APIs, which includes tasks such as retrieving a required access token for the REST API calls.
  2. Use the Update a Self-Registration Profile endpoint to update the profile to support a customer's preferred language. The following request must be made, replacing Host with the applicable host value for your system. You must also provide the required access token, which can be obtained using the Generate access token endpoint, and other applicable authorization requirements in the header of the request:
PATCH {{Host}}/admin/v1/SelfRegistrationProfiles/{SelfRegistrationProfileID}
{
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:PatchOp"
],
"Operations": [{
"op": "add",
"path": "userAttributes",
"value": [
{
"value": "locale",
"deletable": false,
"fullyQualifiedAttributeName": "urn:ietf:params:scim:schemas:core:2.0:User:locale",
"seqNumber": 8
},
{
"value": "preferredLanguage",
"deletable": false,
"fullyQualifiedAttributeName": "urn:ietf:params:scim:schemas:core:2.0:User:preferredLanguage",
"seqNumber": 9
}
]
}
]
}

In addition to updating the self-registration profile, email template updates are required as described in Customize Email Templates.

Back to Top