Skip to main content

Troubleshooting

This document describes common issues with the IAM service and how to resolve them.


CORS error when requesting an API authentication token​

The following error may occur when a client application requests an API authentication token:

CORS error message
Access to XMLHttpRequest at 'https://iam.kakaocloud.com/identity/v3/auth/tokens' from origin 'http://61.109.239.46' has been blocked by CORS policy:
Response to preflight request doesn't pass access control check: No 'Access-Control-Allow-Origin' header is present on the requested resource.

This error occurs because KakaoCloud IAM API does not allow requests from external origins for security reasons.
When an application requests an API authentication token from the KakaoCloud IAM API endpoint, a CORS error occurs if the application's origin differs from the IAM server's origin.

▶️ Resolution: Configure a proxy server to receive client requests, forward them to the IAM server, and return the token response.


API authentication token shows 3-hour validity​

The token appears to be valid for 3 hours because the issued_at and expired_at timestamps are in UTC.

▶️ Resolution: Add 9 hours to issued_at and expired_at to view the timestamps in KST. The token validity period is 12 hours.


Timeout error when obtaining an API authentication token​

When a specific server times out while requesting an API authentication token, repeated token requests in a loop may cause the server's IP address to be blocked.

▶️ Resolution: Check whether the server's IP address is blocked and resolve the issue as follows:

  1. Create another server that uses the same IP address as the affected server, then check whether both servers can obtain an authentication token.

  2. If neither server can obtain a token, try one of the following methods:

    • Operate a server assigned a new IP address.
    • Contact KakaoCloud Support to request that the server's IP address be unblocked.

"Invalid token" popup appears​

The "Invalid token" popup may appear after logging in to the console if multiple login sessions are active in the same browser.

▶️ Resolution: Use only one IAM account to log in to a browser.


User can still access a project after role removal​

Even after all project roles assigned directly to a user are removed from the project details, the user can still access the project if roles assigned through a group or role inheritance remain. Removing project roles in bulk removes only roles assigned directly to the user in that project. Roles inherited or assigned from other resources remain.

▶️ Resolution: Go to Management > IAM > Users, select the user, and open the Projects tab. Expand the project row and check the Assignment path. Remove the role at the location that matches the assignment path.

Assignment pathWhere to remove the role
Group (group name)Remove the group's project role or remove the user from the group
Inherited · UserGo to Management > IAM > Roles > Role inheritance > Users and remove the role
Inherited · Group (group name)Go to Management > IAM > Roles > Role inheritance > Groups and remove the group's role, or remove the user from the group

For details, see Manage role inheritance.


Unable to use OTP or phone number authentication for MFA​

If you cannot access an OTP code after changing or losing your phone, or cannot use phone number authentication, you may be unable to complete MFA when signing in to the console.

▶️ Resolution: Sign in after completing MFA by email, then delete and re-register the existing authentication method as follows:

  1. On the Login two-factor authentication screen, select Cloud account (email) or Contact email to complete MFA, then sign in.

  2. In the upper-right corner of the console, go to Profile > Account information > Contact and two-factor authentication information. Delete the existing OTP or phone number authentication method, then register a new one.

You can register a contact email after signing in to the console. Go to Profile > Account information > Contact and two-factor authentication information in the upper-right corner.