This 4.1.6 release of Cisco Metacloud contains an update that enables single sign-on authentication using Okta SAML.
Single Sign-on Integration
Okta SAML (Security Assertion Markup Language) provides authentication and authorization between Metacloud Identity (keystone) and your service provider. With Single Sign-on (SSO) integration, you no longer need to create individual username and password-based accounts using Metacloud Identity. This allows for easier integration across groups of users and different organizations in your environment.
Single sign-on provides key advantages, for example:
- There is no longer a need to provision user entries in the Metacloud Identity service, since the user entries already exist in your Identity Provider’s (IdP) databases. A common identity store is useful as it can be set up properly once and used in multiple places.
- With SSO, user credentials are provided and maintained by the IdP to allow access to different services in your environment.
- Single sign-on is easier and faster for users and requires fewer password resets. The IdP manages user identities and passwords so Metacloud does not have to.
- User groups can be mapped between the IdP and Keystone, administrators do not have to do any per-user group or role assignments in Metacloud Identity, it is done centrally at the IdP.
- Administrators no longer spend time administering identities in various service providers.
Setting up Single Sign-on Authentication
To authenticate users, the group names from Metacloud must be mapped to target groups in your IdP. Create a Metacloud project for users requiring single sign-on access using the group names that exist in your IdP; then add Metacloud users and assign their roles (either admin or member).
To set up SSO using SAML, you must add an application to your company’s Okta instance and create your Identity Provider Metadata XML file. The Metacloud Support team requires the IdP metadata file to configure and deploy SAML authentication for your users.
To create the Identity Provider Metadata XML file:
- Log in as an administrator to your company’s Okta instance.
- Click Admin on the top right of the Okta Dashboard.
- Select Applications from the Applications drop-down menu.
- Click Add Application.
- Click Create New App and select SAML 2.0.
- Enter a name for your project and click Next.
Enter your Availability Zone (AZ) url for single sign-on in the URL field. For example:
https://<my public API URL>:5000/Shibboleth.sso/SAML2/POST
Enter your AZ specific entityID in SP Entity ID, for example:
https://<my API URL>:5000
- Select Unspecified for the Name ID format.
- Select Okta Username for the Application Username.
- Click Advanced Settings.
- Select Encrypted for Assertion Encryption and upload your Metacloud SAML certificate (mc-sp-cert.pem) in Encryption Certificate. The certificate is provided by Metacloud Support.
Enter the following in one line in the Attribute Statements section:
- Enter the following in one line in the Group Attributes section, to send all groups to Metacloud that the user is a member:
unspecified, regex, .*
- Click Next.
- Select Okta Customer, and Internal App, and then click Finish. Your Application Details page displays.
- Select the Sign On tab and click View Setup Instructions.
- Save the XML file located in the Optional section as Identity Provider Metadata and add it to the request you created for the Metacloud Support team.
The Metacloud Support team will then configure and deploy your Metacloud instance for single sign-on authentication.
See the Okta help site Using the App Integration Wizard for more detailed information.
To log in to the Metacloud Dashboard:
- Select okta SAML Login from the Authenticate Using drop-down menu.
- Click Sign In.
- In LDAP-configured environments group settings are managed outside of Metacloud; you can no longer modify groups in Metacloud if you are using an LDAP configured environment.
- Image formats now correctly display on the Dashboard for Ceph (AMI, ISO, and Raw) and NFS (AMI, ISO, QCOW2, Raw, VDI, VHD, and VDMK).
There are no known issues reported in this release.
Supported API Versions
Supported OpenStack Projects and Versions
Supported Image Types
|Image Storage Location||Local Storage||NFS-backed Storage||Ceph-backed Storage|
|QCOW2 (KVM, Xen)||x||x||N/A|