- Scripts to run workflows from a YAML context or run inputs (kab_run_workflow.py, with --input name=@file), store per-project discovery connections, bootstrap agent MCP keys, refresh the KAB token, publish reports and build estate snapshots. - Hyperscaler discovery servers extended in place; cloud-knowledge folded into them. - deploy/crucible-kab-dev.yaml: the Discovery package agent and the Assessment agents. - Platform issue write-ups and current-wiring notes under docs/platform-issues/. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.0 KiB
Giving KAB read-only access to a cloud estate
For a customer's cloud administrator, and the Kyndryl engineer working with them. These steps give the discovery servers read-only access to one estate. The role lists below are starting points: they haven't yet been tested against a real estate.
Discovery reads metadata only. It doesn't read files, database rows, documents or secret values, and it can't change anything. People's names and email addresses are removed from what it collects.
Enter the values under Credentials in KAB, for the engagement's project and the matching server. Then use the page's test to confirm the connection.
Azure
- Create an app registration and a client secret in Microsoft Entra ID.
- Assign it Reader at the management group or subscription to be discovered.
| Field | Value |
|---|---|
tenant_id |
The Entra tenant id |
client_id |
The app registration's id |
client_secret |
The client secret |
scope_root |
managementGroups/<id>, subscriptions/<id>, or one resource group, subscriptions/<id>/resourceGroups/<name> (azure-discovery 0.1.5 or later) |
cloud |
Optional: public, usgov or china |
For a short trial on your own estate only: leave those three fields blank and put a token in access_token, from az account get-access-token --resource https://management.azure.com --query accessToken -o tsv. It expires within about an hour, after which calls fail until you store a new one. It carries your own permissions, not Reader, so never use this for a customer.
AWS
- Create a read-only IAM role, with the AWS managed policies SecurityAudit and ViewOnlyAccess, plus the
wellarchitectedread actions if you use the Well-Architected Tool. - Set its trust policy to allow Kyndryl's broker identity, and require an external id.
- To collect organisation policies, create the role in the management account or a delegated administrator account.
- For more accounts, create a role with the same name in each, trusting the first role.
| Field | Value |
|---|---|
access_key_id, secret_access_key |
The broker identity that assumes the role |
role_arn, external_id |
The role and its external id |
regions |
Comma-separated regions; the first is the default |
account_ids, member_role_name |
Optional: member accounts, and the role's name in them |
aggregator_name |
Optional: an AWS Config aggregator |
Google Cloud
- Create a service account and a JSON key.
- Grant it, at the organisation, folder or project: Cloud Asset Viewer, Browser, Compute Network Viewer and Organization Policy Viewer, plus the Recommender viewer roles.
- Enable the Cloud Asset, Organization Policy and Recommender APIs.
| Field | Value |
|---|---|
scope_root |
organizations/<id>, folders/<id> or projects/<id> |
service_account_json |
The JSON key |
Removing access
Delete the credential in KAB, then delete the app registration, role or service account in the customer's cloud. Removing it from the cloud takes effect at once.