Overview

As Oracle prepares to upgrade all the tenancies with IAM domains, there are some nuanced changes in the login experience. I will cover mapping between IDCS instances and IAM domains in the upgraded tenancies and changes in the login experience. Some of the PoC, LA, and SaaS tenancies already saw the upgrade in the last few weeks. Other tenancies will get upgraded sometime in the next few months.

Upgraded

IDCS to Identity Domain Mapping

At a high level, the upgrade moves IDCS instance management and administration to the OCI console. There are no changes in the IDCS data plane, including any REST APIs. Native OCI IAM service gets upgraded to a full-fledged Identity domain. The Identity domain mapping is as below.

  • Native OCI IAM service is upgraded to a default Identity domain.
  • The primordial IDCS stripe is upgraded to the OracleIdentityCloudService Identity domain. We will refer to the identity domain as the IDCS identity domain for simplicity.
  • All the IDCS instances, including Fusion IDCS instances, are upgraded Identity domains in the tenancy.

IDM Domain Mapping

IAM Federation Mapping

In an existing setup, SAML integration and group mapping exist between the native OCI IAM service and IDCS primordial instance. As the primordial stripe is upgraded to an Identity domain, the group mapping is retained between the default and IDCS identity domains. However, no SAML integration exists between the default and IDCS Identity domains. Below is the impact on the rest of the SAML integration with native OCI IAM and the primordial IDCS instance.

  • SAML integrations with the primordial IDCS instance are retained.
  • SAML integration with the OCI IAM and retained as well. However, those SAML integrations are read-only and cannot be modified.

SAML Mappings

Identity Domain Login Experience

In an Identity Domain tenancy, you login to the OCI console via one of the Identity domain users. To login, browse to https://cloud.oracle.com and enter the tenancy name.

OCI Tenancy Name

After you enter the tenancy name, you have to choose a domain to login. 

Domain Chooser

Identity Domain Login Experience Upgrade

In an existing OCI tenancy setup, you can login to the tenancy using four ways. The impact and the changes in the login experience for each of the four ways is documented below. 

Native OCI IAM local user

If you login to the OCI console as native OCI IAM user, you can login as the same user in the Default identity domain. 

OCI IAM local user

The primordial IDCS stripe local user

If you login to the OCI console via a local user in the primordial IDCS instance then in the upgraded tenancy, you login to OracleIdentityCloudService Identity domain as a local user.

IDCS Local User login

Federated User via Native OCI IAM federation

If there are any SAML federations setup with native OCI IAM, those federations along with their group mapping are preserved in the upgraded tenancy. The login experience would change as shown in the below screenshot. You do not have to choose an Identity domain. You choose 3rd party SSO provider and login through that.

Local Federated User Login

 

Federated user via primordial IDCS stripe federation

If there are any SAML federations setup with the primordial IDCS instance, those federation integrates are preserved as-is. You would choose to login to the OracleIDentityCloudService identity domain in the upgraded tenancy and login via the required SAML federation.

IDCS Federated User login

Conclusion

While there are nuanced changes in the login experience, all existing authentications and authorizations will succeed. You will, however, create new groups, dynamic groups, and IAM policies using the identity domain constructs. If you have any questions about the impact of the upgrade or if you want to understand identity domain mappings, please write to us in the comments below. 

Resources