corestack_ http_ auth_ update
Change HTTP authentication.
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
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
The whole-environment rule's switch.
Return the secret to you instead of opening it in the person's browser. Needs exec. Defaults to false.
Up to 20 items.
Fields of each item
An existing rule's id; leave it out for a new rule. At least 1.
null for the whole environment (at most once), else a path such as /admin. Up to 200 characters.
Up to 10 items.
Fields of each item
Let the control panel generate the password (shown in the person's browser).
An existing login's id; leave it out for a new login. At least 1.
12–72 characters with a letter and a digit; or send generate: true.
Up to 32 characters.
At least 1.
The set's version from corestack_http_auth_get. At least 0.
Example 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
| Reason | What to do |
|---|---|
deleted | The site is deleted (in its grace period); restore it with corestack_site_restore_deleted first. |
provisioning | The site is still being created; wait for corestack_site_provisioning_get to finish. |
stale | The object changed since you read it; read it again and call with the new version. |
managed_elsewhere | Another 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_arguments | The 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_mismatch | The object does not exist or the token may not see it. Check the id. |
scope_required | The token lacks a scope this call needs. Open the link in the answer to add it, then call again. |
pin_refused | The 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_limited | Too many calls. Wait for the number of seconds the answer names. |
temporarily_unavailable | The Control Panel could not answer just now. Nothing was started; try again shortly. |
internal_error | Something went wrong on our side. Quote the trace id to support. |