CorefinityCorefinityDocs
Open the Control PanelControl Panel
Password protection · 2 of 3

corestack_http_auth_update

Change HTTP authentication.

Scope writeAlso exec to reveal secretsRuns as a taskCan return a secretCoreCluster
On this page

When to use it

Replace a row's HTTP authentication set at its version: the whole-environment switch and the protected paths with their logins. A login's password is either one you send or one the Control Panel generates (generate: true), which opens in the person's browser.

Ask for it

Prompt
Using the Corefinity MCP server, call corestack_http_auth_update with site_id 4211, version 3, rules [{"path_prefix":null,"enabled":true,"users":[{"username":"client","generate":true}]}]. (Change HTTP authentication.) Tell me what it returned.

Inputs

enabledboolean

The whole-environment rule's switch.

reveal_to_agentboolean

Return the secret to you instead of opening it in the person's browser. Needs exec. Defaults to false.

rulesarray of objectsRequired

Up to 20 items.

Fields of each item
enabledbooleanRequired
idinteger or null

An existing rule's id; leave it out for a new rule. At least 1.

path_prefixstring or nullRequired

null for the whole environment (at most once), else a path such as /admin. Up to 200 characters.

usersarray of objectsRequired

Up to 10 items.

Fields of each item
generateboolean

Let the control panel generate the password (shown in the person's browser).

idinteger or null

An existing login's id; leave it out for a new login. At least 1.

passwordstring

12–72 characters with a letter and a digit; or send generate: true.

usernamestringRequired

Up to 32 characters.

site_idintegerRequired

At least 1.

versionintegerRequired

The set's version from corestack_http_auth_get. At least 0.

Example call

tools/call
{
  "name": "corestack_http_auth_update",
  "arguments": {
    "site_id": 4211,
    "version": 3,
    "rules": [
      {
        "path_prefix": null,
        "enabled": true,
        "users": [
          {
            "username": "client",
            "generate": true
          }
        ]
      }
    ]
  }
}

If it is refused

ReasonWhat to do
deletedThe site is deleted (in its grace period); restore it with corestack_site_restore_deleted first.
provisioningThe site is still being created; wait for corestack_site_provisioning_get to finish.
staleThe object changed since you read it; read it again and call with the new version.
managed_elsewhereAnother control panel manages this site, so use that control panel for it. This is refused before anything else about the site, as in the Control Panel and the API. Nothing was done.
invalid_argumentsThe arguments do not match the tool's input schema, or the Control Panel refused a field. Fix the fields named in the answer and call again.
tenant_mismatchThe object does not exist or the token may not see it. Check the id.
scope_requiredThe token lacks a scope this call needs. Open the link in the answer to add it, then call again.
pin_refusedThe grant is limited to chosen clusters, sites or environments, and this call is outside them. Open the link in the answer to widen it.
rate_limitedToo many calls. Wait for the number of seconds the answer names.
temporarily_unavailableThe Control Panel could not answer just now. Nothing was started; try again shortly.
internal_errorSomething went wrong on our side. Quote the trace id to support.

The same task elsewhere

Was this helpful?
Open in ClaudeOpen in ChatGPT