Get Started - Complete tutorial to Deploy Managed Keycloak ​

Step 1 - Create an account ​

To create a deployment, you will need to create a Cloud-IAM account and accept the Terms of Service.

Here is the process to create an account.

Step 2 - Create a Deployment ​

You are now logged into the application, and it's time to deploy your Keycloak. To do so, make sure you are on the "Deployments" page. You can verify this by:

• The deployment category is underlined.
• The URL is as follows: https://app.cloud-iam.com/deployments?

Now, click on the [Create New Deployment] button. By clicking this button, you will be redirected to the deployment configuration page.

Step 3 - Configuration deployment page ​

You've now reached the deployment configuration page

Named your deployment ​

Start by giving your deployment a name.

Choose your plan ​

Choose your plan - configuration page

As you can see, there are several plans available, each with a maximum number of Users and Realms. By selecting one of the icons, you can adjust these limits. We recommend choosing a plan that suits your current needs and natural growth.

Here you will find a table summarizing the features and limits of each plan.

Choose your Cloud Provider and the region ​

From the dropdown menu, you can choose your preferred Cloud Provider and the region in which you want to deploy your Keycloak.

The geographical location of your deployment is crucial. We recommend deploying your Keycloak in the region where the majority of your users are located to minimize latency during login.

Here you will find a table summarizing the cloud providers as well as the regions where you can deploy your keycloak.

Choose your Support Level ​

You can now choose your level of support from the three available options: Standard, Professional, Expert, by clicking directly on the buttons.

Each support level has specific details regarding the assistance provided (on the Cloud-IAM application, on your Keycloak, and for incidents), access to communication features, SLA (Service Level Agreement), types of communication in case of incidents, and access to a ticket center.

Here you will find a table that lists, point by point, the rights and access you will have at each support level.

Choose your billing granularity ​

On this configuration step, you can select the subscription duration you prefer by clicking one of the subscription buttons:

• Monthly
• Yearly, with an automatic 10% discount applied, and the savings you'll achieve.

Subscribe and create deployment ​

Congratulations, you have just configured your deployment. Please take a final moment to ensure that it aligns with your use case.

Then, simply click on the [Subscribe and create deployment] button, you will be then redirected to the payment page.

Step 4 - Payment Page ​

From the "Stripe" payment page, you will find:

• On the left: the summary of your deployment, its pricing linked to the subscription, VAT corresponding to your country, and the option to enter a promotional code (If you have a discount coupon, you can enter it by clicking on "Add promotion code").

• On the right: the billing information to be filled in: your name and your location for VAT application. The form varies according to the chosen payment method.

The available payment methods on this page are : Credit Card or SEPA Direct Debit.

Credit Card ​

To proceed a payment by credit card, you need to provide:

• Card number
• Card expiration date
• CVV (Card Verification Value)
• Cardholder's name

SEPA Direct Debit ​

To proceed a payment by SEPA Direct Debit, you need to provide:

• IBAN
• Name

Subscribe ​

To finish the payment, you just need to provide the information if you are making the purchase for a business, and click on "Subscribe" on Stripe. After clicking "Subscribe," you will be redirected to the application.

Step 5 - Confirmation of deployment creation ​

🎉 Congratulations, you have just created your Keycloak deployment ! 🎉

This redirection informs you that your deployment is currently being created. From our side, this will trigger the automatic creation of your cluster.

Emails confirmation ​

You will receive 2 email after the process finalized the cluster setup :

• One for your payment confirmation from Stripe with the bill.
• One confirming that your Keycloak is ready to use. If you have associated members with your organization, all the members of the organization will receive the email from Cloud-IAM named : “[Cloud-IAM] deployment your deployment name has been completed 🎉”.

Step 6 - Access to keycloak console ​

Your Keycloak deployment is now created, configured according to your needs, and available. Here are the various methods to access it:

• Confirmation email
• Deployment list page - Cloud-IAM App

Confirmation email ​

From the confirmation email named: "[Cloud-IAM] deployment your deployment name has been completed 🎉".

Click on the URL displayed after "The deployment base URL is." You will be redirected to your Keycloak deployment.

Deployment list page - Cloud-IAM App ​

From the Cloud-IAM application, on the deployment page, a new row should have appeared with the name of your deployment, the plan you have chosen, and the number of users and realms you have.

Click on the "Keycloak console" button, and you will be redirected to your Keycloak deployment.

Step 7 - Keycloak First Log-In ​

Fist Log-In ​

In the Keycloak console, for your initial login, you must use and complete the credentials provided in the confirmation email named: "[Cloud-IAM] deployment your deployment name has been completed 🎉."

Then click on "Sign In," and you will be logged into your Keycloak deployment !

Major Kudo, you are now on your Keycloak deployment!

As mentioned in the confirmation email, to secure your admin account, we recommend that you change the admin credentials of your Keycloak.

Change initial admin password from keycloak ​

To change the initial password for your Keycloak, follow these steps:

1. Click on "deployment-name Administrator."
2. Select "Manage Account."

Once you complete these steps, you will be redirected to the "Keycloak account management" page.

From the "Keycloak account management" page, click on [Signing In] You will then be redirected to the page with the same name.

On the "Signing In Page," you have the option to:

• Change your password.
• Add a second factor of authentication.

We recommend for the admin using a strong password:

• At least 12 characters.
• Random (not resembling a common word or proper name).
• Unique, meaning this password should not be used for any other application.
• Set Up Authenticator Application

Feel free to take a look at our documentation on this subject.

Step 8 - Use it ! ​

🎉 Congratulations! You've successfully created, configured, and initiated your Keycloak deployment with Cloud-IAM. 🎉

Now that you're up and running, feel free to explore more Keycloak features and advanced configurations. Our comprehensive documentation is at your fingertips for detailed insights.

If you have any questions or need assistance with any step, don't hesitate to reach out. Connect with the Cloud-IAM team through our Contact Us page or leverage Cloud-IAM Support for prompt assistance.

Happy exploring, and thank you for choosing Cloud-IAM for your Identity and Access Management needs!