> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ulm.m1amdocs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect 2023.01 - Release Note

Release Date: January 26, 2023

## Announcements

The following are MarketONE Connect Announcements:

* We are migrating documentation from MarketONE Developer site at [https://developer.m1amdocs.com/documentation/](https://developer.m1amdocs.com/documentation/) to our Knowledge Center at [https://docs.vindicia.com/](https://docs.vindicia.com/). New documentation updates will only be available in the [Knowledge Center](https://docs.vindicia.com/).
* We are in the process of updating documentation and UIs to reflect new product names for the following:
  * **IdP UI** renamed to **Identity app**
  * **Admin app** renamed to **Admin console**
  * **Care app** renamed to **Care console**

## Connect Features and Enhancements

This section describes the key updates in this release:

### Identity App's Error Reporting for One Time Password (OTP)

From this release, the Connect **Identity app** handles OTP related error messages on a more granular basis depending on the use case(s). Connect informs the end user about the error, why it occurred, and what steps they need to take next. This information helps end users resolve their issue efficiently to complete their authentication process.

**Note:** The OTP is also referred to as a verification code, OTP code, or simply just code.

| End User Message | Description | Error Type |
| - | - | - |
| <img src="https://mintcdn.com/amdocs-ulm/dRhu6LcnM5ipOkz4/portal/m1Connect/connectReleaseNotes/images/2023_01_errorIdpOTP1.png?fit=max&auto=format&n=dRhu6LcnM5ipOkz4&q=85&s=2bb2d7c2912f8002e5620ebff322ee70" alt="Incorrect OTP error message" width="722" height="1323" data-path="portal/m1Connect/connectReleaseNotes/images/2023_01_errorIdpOTP1.png" /> | The end user enters the wrong digits or the wrong OTP for the current session when prompted. The end user can enter the correct code or choose to have a new code sent. | `invalid-act-consumption` |
| <img src="https://mintcdn.com/amdocs-ulm/dRhu6LcnM5ipOkz4/portal/m1Connect/connectReleaseNotes/images/2023_01_errorIdpOTP4.png?fit=max&auto=format&n=dRhu6LcnM5ipOkz4&q=85&s=8d732bcd4a376b1427e21886b2b942a7" alt="Reached maximum number of times error message" width="700" height="1388" data-path="portal/m1Connect/connectReleaseNotes/images/2023_01_errorIdpOTP4.png" /> | The end user enters the OTP multiple times and exceeds the maximum attempts allowed (using the current OTP). The end user must request a new code. | `action-token-retries-exceeded` |
| <img src="https://mintcdn.com/amdocs-ulm/dRhu6LcnM5ipOkz4/portal/m1Connect/connectReleaseNotes/images/2023_01_errorIdpOTP2.png?fit=max&auto=format&n=dRhu6LcnM5ipOkz4&q=85&s=e50242c72f66ed43caeff737966b86a1" alt="Expired OTP error message" width="699" height="1352" data-path="portal/m1Connect/connectReleaseNotes/images/2023_01_errorIdpOTP2.png" /> | The end user enters an OTP that's expired. The end user must request a new code. | `action-token-expired` |
| <img src="https://mintcdn.com/amdocs-ulm/dRhu6LcnM5ipOkz4/portal/m1Connect/connectReleaseNotes/images/2023_01_errorIdpOTP3.png?fit=max&auto=format&n=dRhu6LcnM5ipOkz4&q=85&s=72109a3d9e8520b448b714206c17cca4" alt="Exceeded number of times error message" width="683" height="1417" data-path="portal/m1Connect/connectReleaseNotes/images/2023_01_errorIdpOTP3.png" /> | The user reaches the maximum number of times they can request a verification code. The end user is sent a clickable link to start over. | `token-max-resend-reached` |
| <img src="https://mintcdn.com/amdocs-ulm/dRhu6LcnM5ipOkz4/portal/m1Connect/connectReleaseNotes/images/2023_01_errorIdpOTP5.png?fit=max&auto=format&n=dRhu6LcnM5ipOkz4&q=85&s=404726aa7bdc4e429dd6d64a1d2fd21f" alt="Invalid session error message" width="1636" height="1294" data-path="portal/m1Connect/connectReleaseNotes/images/2023_01_errorIdpOTP5.png" /> | The Proof Key of Action Token (PKAT) is invalid or has expired for the current session. The end user is sent a clickable link to start over. | `invalid-pkat` |

### Admin User Management

From this release, the **Admin console** > **Team Members page** includes new user management options for roles and accounts:

* Modify admin user's role - This option allows admin users to change another team member's role after they're created. This feature is useful when a role is incorrect and needs to change from Super Admin to Care Representative or vice-versa.
* Suspend an admin user in the **Activating** status - The **Activating** status refers to an admin user who's invited to a service. However, the admin user hasn't activated their account by verifying their email/mobile yet. The suspend feature is helpful when admin user(s) are created by mistake, and require a suspension.

<img src="https://mintcdn.com/amdocs-ulm/dRhu6LcnM5ipOkz4/portal/m1Connect/connectReleaseNotes/images/2023_01_ChangeAdminRoles.PNG?fit=max&auto=format&n=dRhu6LcnM5ipOkz4&q=85&s=5eae86693b95be6a2cfaf9416b673f99" alt="Team member change role actions dropdown and configuration page" width="864" height="208" data-path="portal/m1Connect/connectReleaseNotes/images/2023_01_ChangeAdminRoles.PNG" />

### Privacy And Consent Management via APIs

MarketOne Connect now supports privacy and consent management via APIs. This feature helps businesses to comply with data privacy standards like General Data Protection Regulation (GDPR), California Consumer Privacy Act (CCPA), and Lei Geral de Proteçao de Dados (LGPD). These requirements ensure information is stored, processed, and transmitted securely according to the end user's consents.

Businesses create and manage privacy partners by using Connect's APIs to communicate with end users to obtain their consent about data the business collects and stores. These APIs also allow end users to manage their own privacy and consent.

From this release, the following use cases are supported:

| User Type | Use Case |
| - | - |
| As a Business: Administer privacy partners, scopes, and other privacy and consent management-related configuration. | - Create or add a Privacy Partner - Add/edit consents to a partner - View privacy configurations for a partner - Remove privacy configurations for a partner |
| As an end user: Administer your consents (grant/withdraw), privacy features, and consent management-related configuration with partners. | - Grant consent to share data with a partner - Manage the privacy and consent data shared with a partner - Withdraw one or all consents for a particular partner - Invoke right to forget - Invoke right to erasure - Export PII data for a partner if needed |
| **Note:** Future releases will include UI implementation for the **Admin console** and **Identity app**. | |

### Machine-to-Machine (M2M) Clients and Client Credentials Grant

From of this release, Connect supports the creation of M2M client applications using Connect's OIDC-based APIs and a Client Credentials Grant type ([RFC 6749 section 1.3.4](https://datatracker.ietf.org/doc/html/rfc6749#section-1.3.4)).

Connect's M2M APIs use access tokens for authentication within the OIDC framework. Connect allow customers to manage Connect entities, and synchronize them with customer information in their own systems. See the following [Connect Activation APIs](https://app.swaggerhub.com/apis/Amdocs_Media/ULM-Activation-APIs/Released) used for machine clients.

Configure and view/edit M2M client type applications from the **Admin console** > **OIDC Clients** page.

<img src="https://mintcdn.com/amdocs-ulm/dRhu6LcnM5ipOkz4/portal/m1Connect/connectReleaseNotes/images/2023_01_M2MClienCG.png?fit=max&auto=format&n=dRhu6LcnM5ipOkz4&q=85&s=8d4d19ee0fefec8bedaa190b35bfe7a6" alt="Machine-to-machine client application configuration page" width="3048" height="1775" data-path="portal/m1Connect/connectReleaseNotes/images/2023_01_M2MClienCG.png" />

### Search Users by User ID and External User ID

The Connect **Care console's** enhanced search options allow you to find end users based on their User ID or an External User ID. Care representatives can manage/view all types of end users, and differentiate between the different types of end users.

For example, an end user authenticated by the Connect **Identity app** are assigned a User ID from Connect. End users federated by an external IdP are also assigned an External ID from their external IdP in addition to their User ID from the Connect **Identity app**.

<img src="https://mintcdn.com/amdocs-ulm/dRhu6LcnM5ipOkz4/portal/m1Connect/connectReleaseNotes/images/2023_01_FindUserResult12.PNG?fit=max&auto=format&n=dRhu6LcnM5ipOkz4&q=85&s=c7045bbfe1be8f06b46f48bfdd2a7ac2" alt="Find a user and search results page" width="870" height="409" data-path="portal/m1Connect/connectReleaseNotes/images/2023_01_FindUserResult12.PNG" />

### Authenticate With Magic Link When User Has Password

As of this release Connect supports authentication/login with a Verification link (Magic link) even if the user has a password. Majic links are implemented by using the associated notification template to onboard the end user. See the [Admin console templates](https://docs.vindicia.com/bundle/b_connectAdminGuide/page/topics/branding_c.html) for more details.

This capability is helpful for applications that want to accommodate users that have forgotten their password but do not want to reset it, or simply do not want to type in their password.

### Email Domain Block-list

As of this release, admin users can create a list of blocked or prohibited email domains that can't be used by the end users. This setting is enabled once you've added an email domain to the **block-list**. Additional email domains can be added to the list by entering a comma-separated list of email domains in the **Admin console** > **Authentication** > **Authentication Identifiers** page.

<img src="https://mintcdn.com/amdocs-ulm/dRhu6LcnM5ipOkz4/portal/m1Connect/connectReleaseNotes/images/2023_01_EmailDomainBlocklist.png?fit=max&auto=format&n=dRhu6LcnM5ipOkz4&q=85&s=3557d33c6414e06ab62dd0e230ff3d5f" alt="Email domain block-list configuration page" width="539" height="426" data-path="portal/m1Connect/connectReleaseNotes/images/2023_01_EmailDomainBlocklist.png" />

### Validate Identity with One Time Password (OTP)

This is a new method of authenticating an end user's identity by care representatives (CSRs) or machines. The CSRs or machines request an OTP, and the user responds via phone or chat with the OTP. The CSR or machine verifies that the OTP is correct by entering it, and upon successful authentication, verifies the end user's identity.

**Admin API**

POST /admin/token

**Activation API**

POST /activation/token

See the [Developer hub](https://docs.vindicia.com/category/developerhub) for more details.

## Bug Fixes

The bug fixes in this release are:

| Issue | Resolution |
| - | - |
| Blank space character was allowed on Care Console user creation screen. A blank space character (Unicode U+0020) is allowed as part of an email address when creating a new user. For example " [bob123@gmail.com](mailto:bob123@gmail.com)" is accepted as a valid email. | The Care console now removes the blank space before Connect stores the email value on the database. |

## Known Issues

There are no known issues in this release.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.