For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/es/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/es/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/es/guides/public-cloud/containers-orchestration/managed-rancher-service/managed-rancher-service-iam-authentication.md.
Ir al contenido

Configure access control using OVHcloud IAM on an OVHcloud Managed Rancher Service

Ver como Markdown

Learn how to enable and manage OVHcloud IAM authentication to control access to your Managed Rancher Service (MRS) using centralized identities and roles

Objective

OVHcloud Managed Rancher Service (MRS) supports authentication through OVHcloud IAM, allowing you to manage access using centralized user identities and roles.

This guide explains how to enable IAM authentication and control user access to your Rancher service using OVHcloud IAM users and roles.

Requirements


OVHcloud Console Access

  • Direct link:
  • Navigation path: Public Cloud > Select your project > Containers > Managed Rancher Service

Instructions

Introduction to OVHcloud IAM

OVHcloud IAM (Identity and Access Management) is a centralized system that lets you control who can access your OVHcloud services and what actions they can perform. It provides fine-grained access management through users, groups, and roles.

When integrated with the Managed Rancher Service (MRS), OVHcloud IAM replaces Rancher's local authentication system. This allows you to:

  • Use Single Sign-On (SSO) with your OVHcloud credentials to access Rancher.
  • Assign predefined IAM roles (such as base, ovhRestrictedAdmin, standard) to define access levels.
  • Manage permissions efficiently at scale using IAM groups and projects.

Integrating IAM with your Rancher service ensures consistent access control across all your OVHcloud resources, reducing manual management and improving overall security.

Activate/disable authentication via OVHcloud IAM

Warning

When you enable OVHcloud IAM authentication on your Managed Rancher Service:

  • Local users will remain functional, so you can continue logging in with your usual Rancher accounts.
  • If the "admin" password is regenerated while IAM authentication is enabled, or if no user has ever logged in locally, the ability to log in with the IAM root user will be impossible. To restore access with the IAM root user, log in first with a local admin account.

From this point on, IAM roles and policies control access for users authenticated via OVHcloud IAM.

Via the OVHcloud Console
Via the OVHcloud API
OVHcloud CLI

In your Public Cloud project, click Managed Rancher Service under Containers in the left-hand menu. Click the ... button on the row of the relevant Rancher, then select Configure IAM authentication. The same action is available in the Manage Rancher card of the Rancher's details page.

  • To enable IAM authentication, click Enable in the Enable authentication via OVHcloud IAM dialog.
  • To disable it, click Switch back to Local DB in the Switch back to Local DB dialog. Access then falls back to the local Rancher admin accounts: remember to regenerate the admin password with the Generate access credentials action.

Once IAM authentication is enabled on your Managed Rancher Service, access to the Rancher UI is managed via OVHcloud Single Sign-On (SSO). Users no longer log in with local Rancher credentials but authenticate directly using their OVHcloud IAM identity.

Info

Local Rancher users remain functional even after enabling OVHcloud IAM, but their use is not recommended. Access and permissions should be managed through OVHcloud IAM roles and policies for consistency and security.

To log in via SSO:

  • In your Public Cloud project, click Managed Rancher Service under Containers in the left-hand menu, then click the ... button on the row of your Rancher and select Access Rancher UI.

  • You will be redirected to the Managed Rancher Service authentication page.

No user has ever logged in locally

Click on Use a local user to go to the local login page.

To recover the admin password required for authentication, use the following API call:

Replace:

  • projectId with the ID of your Public Cloud project.
  • rancherId with the ID of the Managed Rancher Service.

Or with the OVHcloud CLI:

ovhcloud cloud managed-rancher reset-admin-credentials <rancher_id> --cloud-project <project_id>

Copy the returned password, then paste it on the authentication page.

Make sure to check the box to accept the End User License Agreement & Terms & Conditions, then click Continue.

You can now log out and proceed with your normal workflow.

Click on Log in with OIDC, which will take you to the OVHcloud authentication page. There, log in using your OVHcloud IAM credentials.

login with SSO

  • Access to Rancher is granted based on the IAM role associated with your user account.
Info

Only users with the appropriate IAM role (base, standard and ovhRestrictedAdmin) can access the registry after IAM authentication is enabled.

Managing access rights with OVHcloud IAM

OVHcloud IAM provides three predefined roles for managing access to your Managed Rancher Service (MRS):

  • base
  • standard
  • ovhRestrictedAdmin
Info

base role: Base users can only log in and do not have any additional permissions.

standard role: Standard users can create new clusters and manage clusters and projects they have been granted access to.

ovhRestrictedAdmin role: OVHcloud Restricted Admins have full control over all resources in downstream clusters but do not have access to the local cluster.

These roles are assigned through IAM policies. To create a policy, open Identity and Access Management in the left-hand menu of the OVHcloud Console, click Policies, then Create a policy.

Name your policy, then in the Identities section select the users you want to include and, optionally, user groups (Groups tab) if they have already been created.

Set permissions for MRS:

  • In the Product types section, select Public Cloud Project / Managed Rancher Service (MRS).
  • In the Resources field of the same section, choose the specific MRS service to which the policy will apply.
  • In the Actions section, expand the ROLE category of publicCloudProject/managedRancher and tick the desired role for the identities defined in the policy: publicCloudProject:rancher:managedRancher/base, publicCloudProject:rancher:managedRancher/standard or publicCloudProject:rancher:managedRancher/ovhRestrictedAdmin.

Go further

To go further you can look at our guides on:

For training or technical assistance implementing our solutions, contact your sales representative or visit our Professional Services page to request a quote and have your project analysed by our experts.

  • Our team remains available on our dedicated Discord channel, do not hesitate to join and reach us: https://discord.gg/ovhcloud. Ask questions, provide feedback and interact directly with the team that builds our Container and Orchestration services.

Join our community of users.

¿Le ha resultado útil esta página?