Application

Prev Next

Available in Classic and VPC

Once you have confirmed the CAPTCHA support specifications, you are ready to start using CAPTCHA. Now, process and manage your subscription to CAPTCHA. You can request and manage your subscription to CAPTCHA in the Application menu of NAVER Cloud Platform console.

Note

Since CAPTCHA is an API based service, you can only request, cancel, and manage a subscription in the NAVER Cloud Platform console.

The following summarizes what you can learn from this guide.

Request subscription

There is no separate procedure for requesting a subscription to CAPTCHA. You can create and manage an application directly from Services > AI·NAVER API > AI·NAVER API in the NAVER Cloud Platform console. To create an application, you must agree to the API service terms and conditions in the NAVER Cloud Platform console. The API service terms and conditions contain the rights and obligations of the user, usage limits and usage fees, and special terms and conditions, so you must check them before using CAPTCHA.

Note

You must agree to the API service terms and conditions when you use NAVER Cloud Platform's AI·NAVER API service for the first time. If you are already using other AI·NAVER API services, you can skip the process and go to Register Application.

To use CAPTCHA, you can agree to the API service terms and conditions as follows:

  1. Access the NAVER Cloud Platform console.
  2. From the Region menu, click and select the Region you're using.
  3. From the Platform menu, click to select between VPC and Classic.
  4. Click the Services > AI·NAVER API > AI·NAVER API menu in that order.
  5. Click the Application menu.
  6. Click the [Register Application] button.
  7. When the AI·NAVER API terms and conditions screen appears, click Agree to the AI·NAVER API terms and conditions.
  8. Click the [OK] button.
  9. Check the list of Applications that can be registered and proceed to the next step.
Note

You can go directly to the page in 6. by clicking the [Request subscription] button in Services > Application Services > CAPTCHA of the NAVER Cloud Platform portal.

Register Application

After agreeing to the API service terms and conditions, you must register the Application. The Application is necessary to use CAPTCHA's API. When an Application is registered, a unique Client ID and Client Secret value are created for each Application. This is because the Client ID and Client Secret value are included in the HTTP header value and transmitted when calling the API.

Note

For a detailed description of how to call the API, see NAVER integrated API call in the NAVER Cloud Platform API guide.

The following describes how to register an Application.

  1. From the NAVER Cloud Platform console's Region menu, click and select the Region you're using.
  2. From the Platform menu, click to select between VPC and Classic.
  3. Click the Services > AI·NAVER API > AI·NAVER API menu in that order.
  4. Click the Application menu.
  5. Click the [Register Application] button.
  6. Enter the Application name.
    • Up to 20 characters can be entered.
    • Depending on the service, the Application name may be displayed on the screen, so use a name with up to 10 characters.
  7. Click on CAPTCHA (Image) or CAPTCHA (Audio) in the Select Service area depending on the purpose of your use.
    • [Service description/fee information] button: click and go to the service introduction screen of the NAVER Cloud Platform portal
    • [Development guide] button: click and go to CAPTCHA user guide.
  8. Enter the service environment of the Application in the Service environment registration area. (Optional)
    • Web service URL
      • Up to 10 web service URLs with http:// can be entered.
      • No difference between http and https. Enter excluding www. <Example> http://naver.com
      • Enter the main domain only even if there are sub-domains.
      • If information of the service URL differs from the web used, the authentication may fail.
      • For hybrid apps, enter location.href object outputs <Example> file://local URL
    • Android app package name
      • For Android applications only, up to 10 inputs are allowed.
      • If the entered package name differs from the package name of the using app, the authentication may fail.
    • iOS Bundle ID
      • For iOS applications only, up to 10 inputs are allowed.
      • If the registered bundle ID differs from the information of the app used, the authentication may fail.
Note

The Client ID and Secret value issued for one Application may be applied to multiple environments including Android, iOS, web, Windows App, etc. However, the API usage is added up by each client ID.

  1. Click the [Register] button.

View Application information

You can check the list of registered Applications in the AI·NAVER API > AI·NAVER API > Application menu in the NAVER Cloud Platform console. The following describes how to check Application information in the Application list.

  1. From the NAVER Cloud Platform console's Region menu, click and select the Region you're using.
  2. From the Platform menu, click to select between VPC and Classic.
  3. Click the Services > AI·NAVER API > AI·NAVER API menu in that order.
  4. Click the Application menu.
  5. Check Application information.
    • App name: app's name when registering the Application
    • Service category: selected service when registering the Application
    • Daily/monthly usage: real-time usage by service (based on UTC+9)
    • Limit and notification setting: API call usage limit and notification setting when a specific value (%) is exceeded
    • Registration date: the date the Application was registered
  6. Click the [Authentication information] button.
    captcha-application_02_ko
  7. When the authentication information window appears, check the authentication information.
    • Application Key
      • Application name: the name to identify the Application
      • Client ID (X-NCP-APIGW-API-KEY-ID): enter X-NCP-APIGW-API-KEY-ID in the header or query string as the ID required for authentication. clovasummary-ico_01 Able to copy value on click
      • Client Secret (X-NCP-APIGW-API-KEY): enter X-NCP-APIGW-API-KEY in the header or query string as the SecretKey required for authentication. Click clovasummary-ico_01 to copy the value, and click the [Reissue] button to change the value.
    • Service environment
      • Web service URL: value required to use Web SDK
      • Android app package name: value required to use Android SDK
      • iOS Bundle ID: value required to use iOS SDK
  8. Click the [OK] button.
Caution

Make sure the Client ID and Client Secret are kept confidential. If you are concerned about security, reissue the authentication information with new values in 7.

Edit Application

The following describes how to edit the registered Application information.

  1. From the NAVER Cloud Platform console's Region menu, click and select the Region you're using.
  2. From the Platform menu, click to select between VPC and Classic.
  3. Click the Services > AI·NAVER API > AI·NAVER API menu in that order.
  4. Click the Application menu.
  5. Click the [Edit] button of the Application you want to edit.
  6. Edit the necessary information, and then click the [Save] button.

Manage usage

You can check usage status for each registered Application and set various options for billing management.

Check daily/monthly usage

You can see the usage for the day and for the current month as follows:

  1. From the NAVER Cloud Platform console's Region menu, click and select the Region you're using.
  2. From the Platform menu, click to select between VPC and Classic.
  3. Click the Services > AI·NAVER API > AI·NAVER API menu in that order.
  4. Click the Application menu.
  5. In the Application list, check the real-time usage status of the daily usage and current month usage of the application for which you want to check the usage.
    • Based on UTC+9
    • The daily usage is reset to 0 at 00:00 AM (KST).
Note

It takes around 1 minute for the actual daily/monthly usage to be reflected.

Set usage limits

You can set up daily and monthly usage limits yourself, to prevent excessive usage fees from being charged. The following describes how to set up a usage limit.

  1. From the NAVER Cloud Platform console's Region menu, click and select the Region you're using.
  2. From the Platform menu, click to select between VPC and Classic.
  3. Click the Services > AI·NAVER API > AI·NAVER API menu in that order.
  4. Click the Application menu.
  5. Click the [Set limits and notifications] button of the application from the Application list for which you want to edit the usage limit.
    captcha-application_03_ko
  6. Enter the monthly and daily limit values under the [Set limits] tab menu.
    captcha-application_04_ko
  7. Click the [Save] button.
Note

You can check the change history of usage limit under the [Limit change history] tab in the Limits and notifications setting pop-up.

Set threshold notifications

You can choose to receive notifications through email or SMS when a certain usage rate of the daily/monthly limit value set by the user is exceeded.
You can set up a threshold notification as follows:

  1. From the NAVER Cloud Platform console's Region menu, click and select the Region you're using.
  2. From the Platform menu, click to select between VPC and Classic.
  3. Click the Services > AI·NAVER API > AI·NAVER API menu in that order.
  4. Click the Application menu.
  5. Click the [Set limits and notifications] button of the application from the Application list for which you want to edit the usage limit.
  6. Select by clicking the checkbox for the daily or monthly limit settings field under the [Set limits] tab menu.
  7. Select the threshold value (%) at which you want to be notified.
    captcha-application_05_ko
    • If 70% is selected, notifications are sent at 70%, 80%, 90%, and 100%.
    • If 90% is selected, notifications are sent at 90% and 100%.
  8. Click the [Save] button.
  9. See Set notification recipients to enter the address at which you want to receive the threshold notifications.
Note

You will not receive notifications if you do not have notification recipients set up, even if you have set up threshold notifications. Make sure to set notification recipients.

Set notification recipients

The following describes how to set up notification recipients and notification methods for when a certain usage rate of the daily/monthly limit value set by the user is exceeded.

  1. From the NAVER Cloud Platform console's Region menu, click and select the Region you're using.
  2. From the Platform menu, click to select between VPC and Classic.
  3. Click the Services > AI·NAVER API > AI·NAVER API menu in that order.
  4. Click the Application menu.
  5. Click the [Set limits and notifications] button of the application from the Application list for which you want to edit the usage limit.
  6. Click the [Set notification recipients] tab menu.
  7. Select a person to receive notifications and the notification method, and then click the [Add] button.
    • To go to Cloud Insight (Monitoring) to add a new person, click the [Manage notification recipients] button.
  8. Once you complete setting up the notification recipients, click the [Save] button.
Note

You can select only registered notification recipients in the Notification Recipient settings. You can add a new contact person in the Notification Recipient menu from Cloud Insight. For more details, see Add recipient in the Notification Recipient user guide.

Unsubscribe

There is no separate procedure for canceling the subscription to CAPTCHA. If you delete the Application of CAPTCHA you created, your subscription is successfully canceled. The following describes how to delete an Application.

  1. From the NAVER Cloud Platform console's Region menu, click and select the Region you're using.
  2. From the Platform menu, click to select between VPC and Classic.
  3. Click the Services > AI Services > AI·NAVER API menu in that order.
  4. Click the Application menu.
  5. Click the Application of CAPTCHA to be deleted, then click the [Delete] button.
  6. When the Delete app pop-up window is displayed, click the [OK] button.