From fa44827ba37035b7c96a32b2fe3b3a0b88bfc803 Mon Sep 17 00:00:00 2001 From: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com> Date: Thu, 19 Nov 2026 08:56:54 -0500 Subject: [PATCH 1/2] feat: hub import disclosure, docs and consent views (phase 4 of #19088) Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com> Co-authored-by: clubanderson <407614+clubanderson@users.noreply.github.com> Co-Authored-By: Claude Opus 5.5 Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com> --- .../added-19164-hub-consent-disclosure.md | 1 + src/docs/api-reference/hub-saas.md | 2 + src/docs/dashboard-sections.md | 2 +- src/docs/design/customers-hub-consent.md | 5 +- src/docs/design/customers.md | 12 ++- src/docs/env-vars.md | 2 +- src/docs/hub-deployment.md | 33 ++++++- src/docs/security-model.md | 6 +- src/docs/telemetry.md | 36 +++++++- src/pkg/hub/assets/dashboard.html | 26 +++++- src/pkg/hub/assets/profile-share.html | 12 ++- src/pkg/hub/customer_consent.go | 86 +++++++++++++++++- src/pkg/hub/customer_consent_store.go | 13 ++- src/pkg/hub/customer_consent_test.go | 91 +++++++++++++++++++ src/pkg/hub/customer_match.go | 2 + src/pkg/hub/customer_match_test.go | 12 ++- src/pkg/hub/static/profile-share.js | 24 +++++ 17 files changed, 339 insertions(+), 26 deletions(-) create mode 100644 changelog.d/added-19164-hub-consent-disclosure.md diff --git a/changelog.d/added-19164-hub-consent-disclosure.md b/changelog.d/added-19164-hub-consent-disclosure.md new file mode 100644 index 0000000000..2918f5cfb2 --- /dev/null +++ b/changelog.d/added-19164-hub-consent-disclosure.md @@ -0,0 +1 @@ +- **Hub: final profile sharing disclosure, a "what was sent" view and admin consent counts** ([#19164](https://github.com/hivecommons/hive/issues/19164)). The Profile sharing page now states what is sent and to whom, that the hive owner and anyone with Customers access on that hive can see and export it, what is never sent, that withdrawal is immediate on the hub and reaches the hive at its next sync, and that the hub cannot recall an exported copy. The disclosure version moves to 2, so a consent given under the earlier "nothing is sent yet" text shares nothing until the person confirms again. Each hive card shows what was last sent and when, from the delivery stamps. Hub admins see consent counts per hive only, in Scale Controls and at `GET /api/saas/admin/profile-share/counts`, with no person, field choice or value. The Customers, telemetry and hub deployment docs now describe the opt-in hub import instead of saying nothing is read from the hub. diff --git a/src/docs/api-reference/hub-saas.md b/src/docs/api-reference/hub-saas.md index 5fb89d1f6f..c3eb4621ec 100644 --- a/src/docs/api-reference/hub-saas.md +++ b/src/docs/api-reference/hub-saas.md @@ -83,6 +83,7 @@ Part of the [Dashboard REST API reference](../api-reference.md); see that page f | `GET` | `/api/saas/hives/{id}/access-log` | Hub auth | Permission-Change Audit Log | `pkg/hub/saas.go:449` | | `GET` | `/api/saas/admin/scale-settings` | Hub admin | Placeholder Pool Scale Settings Get | `pkg/hub/saas.go:466` | | `POST` | `/api/saas/admin/scale-settings` | Hub admin | Placeholder Pool Scale Settings Set | `pkg/hub/saas.go:467` | +| `GET` | `/api/saas/admin/profile-share/counts` | Hub admin | Customers profile sharing: consent counts per hive (`hive_id`, `name`, `consents`, `awaiting_reconfirmation`). No person, field choice or value. `404` while `HIVE_HUB_CUSTOMERS_SHARE_ENABLED` is off | `pkg/hub/customer_consent.go` | | `GET` | `/api/saas/admin/user-countries` | Hub admin | User Country Rollup | `pkg/hub/saas.go:476` | | `GET` | `/api/saas/admin/auth-rollout` | Hub admin | Auth Rollout Readiness Summary | `pkg/hub/saas.go:481` | | `GET` | `/api/saas/admin/notifications` | Hub admin | Hub Notifications Get | `pkg/hub/saas.go:482` | @@ -104,6 +105,7 @@ Part of the [Dashboard REST API reference](../api-reference.md); see that page f | `GET` | `/api/saas/hives/{id}/access-log` | Hub auth | Permission-Change Audit Log | `pkg/hub/saas.go:449` | | `GET` | `/api/saas/admin/scale-settings` | Hub admin | Placeholder Pool Scale Settings Get | `pkg/hub/saas.go:466` | | `POST` | `/api/saas/admin/scale-settings` | Hub admin | Placeholder Pool Scale Settings Set | `pkg/hub/saas.go:467` | +| `GET` | `/api/saas/admin/profile-share/counts` | Hub admin | Customers profile sharing: consent counts per hive (`hive_id`, `name`, `consents`, `awaiting_reconfirmation`). No person, field choice or value. `404` while `HIVE_HUB_CUSTOMERS_SHARE_ENABLED` is off | `pkg/hub/customer_consent.go` | | `GET` | `/api/saas/admin/user-countries` | Hub admin | User Country Rollup | `pkg/hub/saas.go:476` | | `GET` | `/api/saas/admin/auth-rollout` | Hub admin | Auth Rollout Readiness Summary | `pkg/hub/saas.go:481` | | `GET` | `/api/saas/admin/notifications` | Hub admin | Hub Notifications Get | `pkg/hub/saas.go:482` | diff --git a/src/docs/dashboard-sections.md b/src/docs/dashboard-sections.md index 4e4551a998..f386afd6b4 100644 --- a/src/docs/dashboard-sections.md +++ b/src/docs/dashboard-sections.md @@ -226,7 +226,7 @@ Opening a profile shows: - **Merge** (owner and read-write): fold another customer into this profile when they are the same person. Identities, tags, goals and activity come across, and **Undo merge** gives them back exactly. Two dashboard users cannot be merged. **Split off** on an identity moves it, and the activity it produced, to a new customer. - **Export** and **Forget** (owner only): **Export this person** shows everything held about them in a viewer you can copy from. **Forget**: deletes the person, their identities and their activity links, and stops hive rebuilding the profile. -Nothing in this section leaves the hive. Turn it off with **Settings › Features › Customers** (`customers.enabled`), which takes effect when the hive restarts. API: [customers](api-reference/customers.md). Design: [customers](design/customers.md). +Nothing in this section leaves the hive, and nothing is read from the hub, unless the owner turns on **Settings › Features › Import details people shared on the hub** (`customers.hub_import.enabled`, default off). Then the hive sends the hub salted hashes of its confirmed customers' GitHub logins, and a person who opted in on the hub's **Profile sharing** page for this hive can have the real name, organization or country they entered there fill their profile, shown as "from the hub". A value set by hand here is never overwritten, and a withdrawal on the hub clears the imported value at the next sync. See [Customers hub import](telemetry.md#customers-hub-import). Turn the section off with **Settings › Features › Customers** (`customers.enabled`), which takes effect when the hive restarts. API: [customers](api-reference/customers.md). Design: [customers](design/customers.md). ## Contributors diff --git a/src/docs/design/customers-hub-consent.md b/src/docs/design/customers-hub-consent.md index 6ce09561ca..6693a4c53c 100644 --- a/src/docs/design/customers-hub-consent.md +++ b/src/docs/design/customers-hub-consent.md @@ -1,6 +1,9 @@ # Customers: opt-in, consent-first import of hub-held person fields (#19088) -Status: **Decided; design only.** Spec for issue +Status: **Decided; phases 1 to 4 built, off by default.** Operator-facing +docs: [Customer profile sharing](../hub-deployment.md#customer-profile-sharing) +on the hub and [Customers hub import](../telemetry.md#customers-hub-import) on +the hive. Spec for issue [#19088](https://github.com/hivecommons/hive/issues/19088). The operator decided the model in that issue (option 1, below), so this page records it and cuts it into phases; it does not reopen it. No code or behaviour changes with this diff --git a/src/docs/design/customers.md b/src/docs/design/customers.md index be0fbf8849..27dbe6b6e4 100644 --- a/src/docs/design/customers.md +++ b/src/docs/design/customers.md @@ -32,7 +32,9 @@ Goals: Non-goals (this series): - Any outbound path. Nothing is published, written to GitHub, sent to a hub or - added to a heartbeat. + added to a heartbeat. The one later exception is the opt-in, consent-first + hub import in [customers-hub-consent.md](customers-hub-consent.md), off by + default. - An agent-callable query tool. Agents cannot query Hive's stores ([security-model.md](../security-model.md) section 4, [ADR-0011](../adr/0011-knowledge-system.md)); a query tool is a later RFC. @@ -92,7 +94,7 @@ contributor is one of several sources of identity for a person. | `goals` | See section 8. | | `satisfaction` | See section 8. | | `notes` | Free text, written by people only. | -| `profile` | Optional `real_name`, `organization`, `location` and `country`, each `{value, source, rule, at, by}`. `source` is `auto` (the person's own public GitHub profile name, company and location, fetched once on accept; the country derived offline from the location, rule `location`) or `manual` (a person typed it or cleared it; neither the fetch nor the location changes it; `auto` hands it back). `country` is an ISO 3166 alpha-2 code. Also `dismissed_affiliations`, the suggested organizations a person refused (at most 20). Nothing here comes from the hub. | +| `profile` | Optional `real_name`, `organization`, `location` and `country`, each `{value, source, rule, at, by}`. `source` is `auto` (the person's own public GitHub profile name, company and location, fetched once on accept; the country derived offline from the location, rule `location`) or `manual` (a person typed it or cleared it; neither the fetch nor the location changes it; `auto` hands it back). `country` is an ISO 3166 alpha-2 code. Also `dismissed_affiliations`, the suggested organizations a person refused (at most 20). Nothing here comes from the hub, except a `real_name`, `organization` or `country` the person entered on the hub and consented to share with this hive, when `customers.hub_import.enabled` is on ([customers-hub-consent.md](customers-hub-consent.md)). | | `merged_from` | Merge history, so a merge can be undone. | **Identity** `{kind, value, source, confidence, manual, at, by}`. Kinds: @@ -325,8 +327,10 @@ search, and keeps only the name, company and location the person published stand-down, spends one request of that budget, and is never run by the sweep. A suggested person has no profile fields until accepted. Forget deletes the fields with the person and export includes them. The hub's own records of the same people -(name, company, country, notes, inferred affiliation) are not read or copied: that -is the open question in section 15 and needs a consent decision first. +(name, company, country, notes, inferred affiliation) are not read or copied, +except, when the hub import is on, the name, organization and country a person +entered on the hub and consented to share with this hive. Notes and affiliation +never cross. See [customers-hub-consent.md](customers-hub-consent.md). Country and likely affiliation add no request of their own. The country is derived from the location text by a bundled table (country names and aliases, ISO codes, US diff --git a/src/docs/env-vars.md b/src/docs/env-vars.md index e576cf19aa..ddd69f8844 100644 --- a/src/docs/env-vars.md +++ b/src/docs/env-vars.md @@ -93,7 +93,7 @@ behavior. [Maintenance limitations](#keeping-this-reference-current) still apply | `HIVE_HUB_LEGACY_COOKIE_DOMAIN` | No | none | Optional transition-only hub SSO cookie domain to expire alongside the active cookie domain while accepting any carried `hive_hub_user` cookie value during a host migration. Writes still target the domain derived from `HIVE_HUB_PUBLIC_URL`; unset disables the extra legacy-domain cleanup. | | `HIVE_HUB_SECRET` | Required for spokes registered to a protected hub; optional for a standalone hub with `/data/saas/hub-secret.key` | `/data/saas/hub-secret.key` on the hub when present; no fallback for spoke heartbeat auth | Bearer secret for spoke heartbeats and hub/spoke SaaS APIs. Self-hosted (`byo-`) hives registered through self-service never receive it: they hold only their own `HIVE_HEARTBEAT_KEY`, and the hub never tries `HIVE_HUB_SECRET` or anything derived from it for a `byo-` ID. | | `HIVE_HUB_SELFSERVICE_REGISTRATION` | No | off | Enables the self-service registration API (`/api/hub/selfservice/*`) that lets a signed-in user register a hive they run themselves under the reserved `byo---` ID namespace, after proving `permissions.admin` on every listed repo with their own GitHub token ([#18060](https://github.com/hivecommons/hive/issues/18060)). Accepts `1/true/yes/on`. When off, every route but `GET /api/hub/selfservice/status` answers `404` and the status reports `enabled: false`. Read per request; no restart needed. | -| `HIVE_HUB_CUSTOMERS_SHARE_ENABLED` | No | off | Enables the hub's signed-in profile-sharing page and API for per-person, per-hive consent. Accepts `1/true/yes/on`. This phase sends no profile data to hives. See [Customer profile sharing](hub-deployment.md#customer-profile-sharing). | +| `HIVE_HUB_CUSTOMERS_SHARE_ENABLED` | No | off | Enables the hub's signed-in profile-sharing page and API for per-person, per-hive consent. Accepts `1/true/yes/on`. With it on, a hive that turned on `customers.hub_import.enabled` receives only the fields a person consented to share with it and entered themselves. See [Customer profile sharing](hub-deployment.md#customer-profile-sharing). | | `HIVE_ASK_ENABLED` | No | off | Switches on Ask AI help ([#19177](https://github.com/hivecommons/hive/issues/19177)). Accepts `1/true/yes/on`. Inert until the Kapa values below are also set; a missing or unreadable value keeps it off with one warning that names no value. See [Ask AI help](hub-deployment.md#ask-ai-help). | | `HIVE_ASK_MODE` | No | `off` | `off`, `direct` (this process calls Kapa.ai with its own key) or `hub` (a hosted hive uses the hub relay). The hub is always `direct` and ignores it. | | `HIVE_ASK_KAPA_PROJECT_ID` | With Ask on in direct mode | none | Kapa.ai project id. Configuration only; never in the repo, never logged or returned by an API. | diff --git a/src/docs/hub-deployment.md b/src/docs/hub-deployment.md index e8e64b5f78..341ea48910 100644 --- a/src/docs/hub-deployment.md +++ b/src/docs/hub-deployment.md @@ -99,8 +99,37 @@ its API return `404`; stored choices are not deleted. People can enter or clear their real name, organization, and country, then confirm or withdraw their own selections separately for each hive. Legacy, administrator-entered, and inferred values are not eligible for sharing. A -material disclosure change requires reconfirmation. This phase records consent -on the hub only and does not send any profile fields to hives. +material disclosure change requires reconfirmation: disclosure version 2, which +replaced the version that said nothing was sent yet, suspends every earlier +consent until the person confirms again. + +A hive asks for these values only when its owner turns on +`customers.hub_import.enabled` (see +[Customers hub import](telemetry.md#customers-hub-import)). The hive posts +salted hashes of its confirmed customers' GitHub logins to +`POST /api/customers/match` with its per-hive bearer. The hub answers only for +people with an effective consent for that hive, with only the fields they +selected and only values they entered themselves; an unknown and an +unconsented person get the same empty answer. A withdrawal, a lost grant, a +blocked account or a deleted hub user makes the next answer tell the hive to +clear what it was sent. + +What each role sees: + +- **The person**, on the Profile sharing page: per hive, what was last sent and + when, which fields were sent at any time, and when the first delivery was. +- **A hub admin**, in the dashboard's Scale Controls, under **Customers profile + sharing**: the number of consents per hive, and how many await + reconfirmation. No person, field choice or value is shown, and no admin route + can grant, change or read a consent. The same counts are at + `GET /api/saas/admin/profile-share/counts`. +- **The hive owner and anyone with Customers access on that hive**: the values + the hive received, shown as "from the hub". They can export them, and the hub + cannot recall an exported copy. + +Audit lines carry names of fields, never values: `audit: customer consent +grant`, `change` and `withdrawal` per consent change, and `audit: customer match` +per request with the hive id and counts. ### Ask AI help diff --git a/src/docs/security-model.md b/src/docs/security-model.md index 942ef08630..779ea2c721 100644 --- a/src/docs/security-model.md +++ b/src/docs/security-model.md @@ -261,7 +261,11 @@ authoritative list is the switch and the `specialPurposePrefixes` table in The Customers section keeps one profile per person. It lives in two files on the hive's own volume and nothing in it leaves the hive. It is not sent to the hub, -written to GitHub or put in a heartbeat. The design is in +written to GitHub or put in a heartbeat. The one exception is the opt-in +Customers hub import (`customers.hub_import.enabled`, default off): it sends the +hub only salted hashes of confirmed customers' GitHub logins, and receives only +fields a person consented to share with this hive +([telemetry](telemetry.md#customers-hub-import)). The design is in [customers](design/customers.md). Some of these people never signed up. They are issue authors, meeting guests and diff --git a/src/docs/telemetry.md b/src/docs/telemetry.md index 2dc3120a28..5680cb4ae3 100644 --- a/src/docs/telemetry.md +++ b/src/docs/telemetry.md @@ -16,6 +16,7 @@ Hive sends a small number of operational signals outside the running hive only t | Customers enrichment: gitdm snapshot | Nothing about any person. A download of the public cncf/gitdm affiliation files (the same files for every hive), with a generic User-Agent and no hive identity. Matching against confirmed customers runs on the hive. | `github.com` / `raw.githubusercontent.com`, public `cncf/gitdm` repository. | **Off by default** (`customers.enrichment.enabled` and `customers.enrichment.gitdm.enabled`, both needed). Refreshed every `customers.enrichment.gitdm.refresh_interval` (default 24h), with ETags so an unchanged file is not downloaded again. | The snapshot is cached in `/data/customers/colony-cache`; matches are kept in `/data/customers/enrichment.json` until the person is forgotten. | Leave either switch off, or set `HIVE_CUSTOMERS_ENRICHMENT_ENABLED=false`. | [Customers enrichment](customers-enrichment.md); `src/cmd/hive/customers_enrichment.go` (`runCustomersEnrichmentPass`); `src/pkg/customers/enrichment.go`; hivecommons/colony `gitdm`. | | Customers enrichment: devstats lookup | A confirmed customer's public GitHub login, never an email, name or id, with a generic User-Agent and no hive identity. | CNCF devstats (`devstats.cncf.io`). | **Off by default** (`customers.enrichment.enabled` and `customers.enrichment.devstats.enabled`). At most `customers.enrichment.devstats.hourly_limit` lookups an hour (default 30). Suggested people are never looked up, and a person without a confirmed GitHub login is never looked up. Sent as a POST to the public devstats API by the hivecommons/colony client (generic User-Agent, no redirects, rate limited). | Results are kept in `/data/customers/enrichment.json` until the person is forgotten. | Leave either switch off, or set `HIVE_CUSTOMERS_ENRICHMENT_DEVSTATS_ENABLED=false`. | [Customers enrichment](customers-enrichment.md); `src/cmd/hive/customers_enrichment.go` (`runDevstatsStep`); hivecommons/colony `devstats`. | | Customers enrichment: crowd.dev lookup | A confirmed customer's public GitHub login, never an email, name or id, and the owner-supplied crowd.dev API token. | crowd.dev / LFX Insights API. | **Off by default** (`customers.enrichment.enabled` and `customers.enrichment.crowddev.enabled`) and inert without a token. Not active: LFX Insights has no usable public API (hivecommons/colony#5), so no request is made. | Results are kept in `/data/customers/enrichment.json` until the person is forgotten. | Leave either switch off, clear the token, or set `HIVE_CUSTOMERS_ENRICHMENT_CROWDDEV_ENABLED=false`. | [Customers enrichment](customers-enrichment.md); `src/pkg/dashboard/api_customers_enrichment.go`. | +| Customers hub import (optional) | From the hive: its hive ID and a bounded batch of salted HMAC-SHA-256 hashes of the GitHub logins of its **confirmed** customers (never a suggested person, never plaintext, never any other identifier or profile field). From the hub, back to the hive: for a person who consented for this hive, only the real name, organization and country they selected and entered themselves on the hub; for a person previously delivered and since withdrawn, only the names of the fields to clear. | The configured hub, `POST /api/customers/match`, authenticated with the per-hive heartbeat bearer. The hub compares hashes only against consenting people and never stores or logs a non-matching hash; for a match it learns that this hive has that person as a customer. Values received are visible to the hive owner and anyone with Customers access on that hive, who can export them. | Off by default at every layer: the hub switch `HIVE_HUB_CUSTOMERS_SHARE_ENABLED`, the hive switch `customers.hub_import.enabled` / `HIVE_CUSTOMERS_HUB_IMPORT_ENABLED` (Settings, Features), and per person, per hive, per field consent on the hub's Profile sharing page, with nothing pre-checked. With the hive switch off no request is made. | On the hive, a hub value not refreshed within 72 hours is cleared. On the hub, a consent record lives with the person (deleted with the hub user); a withdrawn record is kept at most 90 days while a clear may be owed. | Turn the hive switch off; the person withdraws on the hub (takes effect on the hive at its next hourly sync); or leave the hub switch off. | `src/pkg/customers/hub_import.go`; `src/cmd/hive/customers_hub_import.go`; `src/pkg/hub/customer_match.go`; `src/pkg/hub/customer_consent.go`; [design](design/customers-hub-consent.md). | | Crash/error reporting | No Sentry/PostHog/Segment/Plausible crash reporter was found in `src` during the onboarding audit. Errors are logged locally; selected log-safe health/error strings can appear in hub heartbeats as described above. | Local logs and, for selected operational state, the configured hub. | No third-party crash reporting by default. | Local log/PVC retention is deployment-specific. | N/A for third-party crash reporting; disable hub link for heartbeat-carried operational errors. | Audit search: `telemetry|analytics|metrics push|phone.?home|posthog|segment|plausible|gtag|googletagmanager|sentry` over Go/HTML/JS/Markdown. | ## Linux Foundation telemetry-policy status @@ -23,9 +24,9 @@ Hive sends a small number of operational signals outside the running hive only t | Policy requirement | Hive status | Gap / follow-up | |---|---|---| | Do not collect telemetry by default without Linux Foundation review and approval. | Standalone hives do not heartbeat or send NPS relay data unless configured. Hub-linked/hosted hives always send operational heartbeats to the configured hub. Hosted hub pages load GA4. | Heartbeats and hosted GA4/custom events should be reviewed with CNCF/LF before this onboarding item is marked complete. | -| Specify exactly what is collected. | NPS is documented in `src/docs/nps.md`; feedback diagnostics disclose fields in the UI. This page now documents heartbeats, task-status, feedback, NPS, analytics, and crash reporting. | Keep this page updated when heartbeat or feedback fields change. | +| Specify exactly what is collected. | NPS is documented in `src/docs/nps.md`; feedback diagnostics disclose fields in the UI. This page now documents heartbeats, task-status, feedback, NPS, analytics, crash reporting, and the Customers hub import. | Keep this page updated when heartbeat or feedback fields change. | | Demonstrate anonymization and avoid personal/end-user/confidential data. | No raw secrets are intended in the heartbeat; feedback redacts token/email/secret-looking text; NPS intentionally omits user identity. | Heartbeats can include GitHub usernames, org/repo names, dashboard usernames, current task titles, project identifiers, hive IDs, and GA4 custom event identifiers. These are not fully anonymized and may be business-sensitive. | -| Notify users and require consent before collection starts. | Feedback is explicit and previewed; project org/repo diagnostics require a separate checkbox. NPS has an enable switch and documented defaults. | Hub heartbeats are tied to hub-link configuration and are not separately consented or field-configurable; hosted GA4 notice/consent is not documented in this repo. | +| Notify users and require consent before collection starts. | Feedback is explicit and previewed; project org/repo diagnostics require a separate checkbox. NPS has an enable switch and documented defaults. The Customers hub import is off by default on hub and hive and sends a person's fields only after that person consents, per hive and per field, on a versioned disclosure. | Hub heartbeats are tied to hub-link configuration and are not separately consented or field-configurable; hosted GA4 notice/consent is not documented in this repo. | | Document storage and project-community access. | NPS retention and admin-only read path are documented. Heartbeat and task-status visibility is hub-side operational/admin UI. | Fixed retention for heartbeat/task-status registry data and GA4 retention are not documented. | | Secure the collection mechanism. | Heartbeats and task-status use per-hive derived bearer credentials; heartbeat responses are signed; feedback/NPS size caps and redaction are implemented. | Security posture depends on the configured hub and GA4; continue to review any new phone-home path before enabling it by default. | | Make approved telemetry data available to project participants. | NPS is admin-only by design; hub operational state is hub-admin/operator visible. | If LF approves any project telemetry program, define what aggregate data is shared with the community and where. | @@ -100,6 +101,37 @@ hub: When the cap applies, items needing a human or a decision are kept first, then stalled ones, then the furthest stage, and the number left out is reported as `truncated`. A repository counts as public only when the hub lists the hive as public (`hub.is_public`, its project repos) or it is on `HIVE_PUBLIC_REPOS`. Once the hub acknowledges a digest's etag, later beats send only `etag` and `generated_at` until the tracker changes. A tracker change also sends an activity-only update over the heartbeat endpoint and bearer, at most one every 15 seconds; changes arriving meanwhile are merged into it. The block also carries `events` ([#15964](https://github.com/hivecommons/hive/issues/15964)): the stage hops, opens and merges the spoke saw since the hub last acknowledged them, derived by diffing successive tracker snapshots (the first one only seeds the baseline), each with a sequence number. At most 200 are buffered; the oldest are dropped first and `events_dropped` discloses how many. Events stay buffered, and are resent, until a heartbeat or update response's `activity_events_ack` covers them. Private-repository items yield no events unless `share_private` is on. The hub keeps at most 1,000 events across the fleet in memory only, and no event is kept longer than 24 hours; when the ring is full it drops the oldest event of the hive holding the most events, so one hive cannot evict another hive's events. `hub.heartbeat_omit` applies: `repos` withholds every item and event (totals remain) and `task_titles` blanks titles. +## Customers hub import + +The Customers section is spoke-local: nothing in it is read from the hub or sent +to the hub **unless** the hive owner turns on the hub import and a person opts in +on the hub. That opt-in path is the only exception, and it is off by default at +every layer ([#19088](https://github.com/hivecommons/hive/issues/19088), design: +[customers-hub-consent](design/customers-hub-consent.md)). + +- **Request (spoke to hub).** Hashes only. Each is an HMAC of a confirmed + customer's GitHub login under a per-hive match key (`HIVE_CUSTOMER_MATCH_KEY`, + derived from the hub secret and hive ID), never the heartbeat bearer. At most + 200 hashes per request and four requests per hourly pass, and once more when a + customer is accepted. A suggested person is never asked about. +- **Answer (hub to spoke).** Only for a person with an effective consent for + this hive: the fields they switched on, only values they entered themselves. + Administrator-entered and inferred values never cross. An unknown person and + an unconsented person get the same silence, so the answer cannot be used to + learn who is on the hub. +- **Consent first.** The person sees what is sent, to whom, what is never sent, + how fast withdrawal takes effect and that exported copies cannot be recalled, + then confirms per hive. A material change to that text suspends sharing until + they confirm again. +- **What the hub learns.** For a consenting person who matches, that this hive + has them as a customer. Non-matching hashes are dropped unlogged. +- **Withdrawal.** Immediate on the hub; the hive clears the fields at its next + sync. A value someone edited by hand on the hive is left alone. A hive that + cannot reach the hub clears hub values after 72 hours. +- **Who sees what.** The person sees, per hive, what was last sent and when. A + hub admin sees only consent counts per hive. The hive owner and anyone with + Customers access on that hive see, and can export, the values received. + ## Telemetry agent The telemetry agent audits and, once opted in, improves the **observability of the managed project** — the repositories the hive watches, not the hive's own internal metrics/tracing (see [Config.OTel/Tracing](operator-reference.md) for that, a deliberately separate concern). It is an L5/L6-only agent: absent from the roster below L5 and paused in every governor mode at L5/L6 until an operator explicitly opts in. diff --git a/src/pkg/hub/assets/dashboard.html b/src/pkg/hub/assets/dashboard.html index 3c85fef141..f474c5ccb7 100644 --- a/src/pkg/hub/assets/dashboard.html +++ b/src/pkg/hub/assets/dashboard.html @@ -190,6 +190,7 @@ .customers-share-setting { padding: var(--sp-5); margin-bottom: var(--sp-6); border: 1px solid var(--border); border-radius: var(--r); background: var(--surface); font-size: var(--fs-base); } .customers-share-setting h3 { font-size: var(--fs-base); margin-bottom: var(--sp-2); } .customers-share-setting p:last-child { font-size: var(--fs-sm); color: var(--muted); margin-top: var(--sp-2); } + .customers-share-counts { font-size: var(--fs-sm); margin-top: var(--sp-2); } /* ── Hive search + facets ── The facet panel is a CLICK-TOGGLED left tray, collapsed by default so the @@ -1094,7 +1095,8 @@

Customers profile sharing

In force: Unknown · Default: Off

-

Set HIVE_HUB_CUSTOMERS_SHARE_ENABLED on the hub to enable the personal profile and consent page. The environment is authoritative; this setting cannot be changed here. No profile details are sent to hives in this release.

+ +

Set HIVE_HUB_CUSTOMERS_SHARE_ENABLED on the hub to enable the personal profile and consent page. The environment is authoritative; this setting cannot be changed here. A hive receives a person's real name, organization or country only after that person consents for that hive, and only values they entered themselves. Counts below are per hive; no person or value is shown.

Per-cluster limits
@@ -11667,6 +11669,27 @@

'; } + /* Hub admin view of profile sharing (#19164): consent counts per hive + only. The endpoint returns no person, field choice or value, and is + absent (404) while the sharing switch is off. */ + async function loadCustomerConsentCounts(enabled) { + var el = document.getElementById('customers-share-counts'); + if (!el) return; + if (!enabled) { el.hidden = true; el.textContent = ''; return; } + try { + var resp = await fetch('/api/saas/admin/profile-share/counts', { credentials: 'same-origin', cache: 'no-store' }); + if (!resp.ok) { el.hidden = true; return; } + var data = await resp.json(); + var rows = data.hives || []; + el.hidden = false; + if (!rows.length) { el.textContent = 'No person has consented to share with any hive.'; return; } + el.innerHTML = 'Consents per hive: ' + rows.map(function(r) { + var line = '' + esc(r.name || r.hive_id) + ' ' + (r.consents | 0); + if (r.awaiting_reconfirmation) line += ' (' + (r.awaiting_reconfirmation | 0) + ' awaiting reconfirmation)'; + return line; + }).join(' · '); + } catch (e) { /* transient: next poll retries */ } + } async function loadScaleSettings() { if (!_isAdmin) return; try { @@ -11682,6 +11705,7 @@

Your details

Hives

What you’re agreeing to

-

No profile details are sent to any hive in this release. You can record your choices now for future syncs.

-

For each hive you choose, only the fields you select may be shared: your real name, organization, or country. Only non-empty values you entered about yourself are eligible. That hive’s owner and anyone with Customers access there can view and export the shared values. When a future sync matches you to a confirmed customer in that hive, the Hub learns about that customer relationship.

-

This feature never sends notes, Slack IDs, email, affiliation, provider-supplied profile details, or anything an administrator entered or the Hub inferred. Information already visible to hive owners through existing access lists is unaffected by these choices.

-

Withdrawal stops sharing immediately on the Hub. Once syncing is available, the hive removes the imported values at its next sync. Withdrawal cannot undo what someone already saw, copied, or exported.

-

Boxes always start unchecked; any previous selection is shown separately. Confirming replaces the entire selection for that hive. Leave nothing selected and use Withdraw consent to remove the entire selection.

+

What is sent. For each hive you choose, only the fields you select: your real name, organization, or country. Only non-empty values you entered about yourself on this page or on the hive request form are sent, and only about you. A value an administrator entered, or a country guessed from your browser, is never sent, even if you select that field.

+

To whom. Only to that hive, and only when it has already confirmed you as one of its customers by your GitHub login. That hive’s owner and anyone with Customers access there can view and export the values. The hive asks by sending salted hashes of its customers’ GitHub logins, so when it matches you, the Hub learns that this hive has you as a customer.

+

What is never sent. Notes, email addresses, Slack IDs, affiliation, profile details from GitHub or your sign-in provider, and anything an administrator entered or the Hub inferred. Information already visible to hive owners through existing access lists is unaffected by these choices.

+

Withdrawing. Withdrawal, or turning a field off, stops sharing on the Hub immediately. The hive removes the values it received at its next sync, normally within an hour, and in any case within three days if it cannot reach the Hub. A value someone on the hive changed by hand is theirs and is not removed.

+

What withdrawal cannot undo. The Hub cannot recall a copy the hive already exported, and cannot undo what someone already saw or copied.

+

Boxes always start unchecked; any previous selection is shown separately. Confirming replaces the entire selection for that hive. Leave nothing selected and use Withdraw consent to remove the entire selection. When this text changes materially, sharing pauses until you confirm again.

Loading your hives…

@@ -68,6 +69,7 @@

+

Choose fields for this hive
diff --git a/src/pkg/hub/customer_consent.go b/src/pkg/hub/customer_consent.go index 2192780a6d..1969abb70d 100644 --- a/src/pkg/hub/customer_consent.go +++ b/src/pkg/hub/customer_consent.go @@ -2,6 +2,7 @@ package hub import ( "encoding/json" + "errors" "io" "net/http" "net/url" @@ -16,7 +17,10 @@ const ( customersShareEnv = "HIVE_HUB_CUSTOMERS_SHARE_ENABLED" // Bump for a material disclosure change. The page submits the version it // displayed, not a version fetched after the person read the disclosure. - customerConsentTextVersion = "1" + // Version 2 (#19164): values are now sent to hives, where version 1 said + // nothing was sent yet, so a version 1 consent is suspended until the + // person reconfirms. + customerConsentTextVersion = "2" maxCustomerConsentBody = 4096 ) @@ -76,6 +80,8 @@ func (s *HubServer) registerCustomerSharingRoutes() { s.mux.HandleFunc("GET /api/saas/me/profile-share/consents", s.requireCustomerSharing(s.handleListCustomerConsents)) s.mux.HandleFunc("POST /api/saas/me/profile-share/consents/{id}", s.requireCustomerSharing(s.handleChangeCustomerConsent)) s.mux.HandleFunc("DELETE /api/saas/me/profile-share/consents/{id}", s.requireCustomerSharing(s.handleChangeCustomerConsent)) + // Hub admin: aggregate counts per hive, never a person or a value (#19164). + s.mux.HandleFunc("GET /api/saas/admin/profile-share/counts", s.requireAdmin(s.handleAdminCustomerConsentCounts)) // Hive-facing: per-hive bearer, not a session. The handler answers 404 // while the sharing switch is off, like the routes above (#19162). s.mux.HandleFunc("POST "+customerMatchPath, s.handleCustomerMatch) @@ -230,3 +236,81 @@ func (s *HubServer) customerConsentError(w http.ResponseWriter, err error) { s.logger.Warn("customer consent store failed", "error", err) writeJSONError(w, http.StatusInternalServerError, "could not access consent records") } + +// customerConsentHiveCount is the hub admin's view of consent for one hive: +// counts only. It names no person and carries no field value or field choice, +// so a hive with one consenting person does not reveal what that person chose. +type customerConsentHiveCount struct { + HiveID string `json:"hive_id"` + Name string `json:"name"` + // Consents is the number of people with a recorded, not withdrawn + // consent under the current disclosure text. + Consents int `json:"consents"` + // AwaitingReconfirmation counts recorded consents given under an older + // disclosure text; they share nothing until the person reconfirms. + AwaitingReconfirmation int `json:"awaiting_reconfirmation"` +} + +// handleAdminCustomerConsentCounts serves aggregate consent counts per hive +// to a hub admin. It reads the consent store only; it never loads a user's +// profile values, and it is absent while the sharing switch is off. +func (s *HubServer) handleAdminCustomerConsentCounts(w http.ResponseWriter, r *http.Request) { + w.Header().Set("Cache-Control", "no-store") + if !customersShareEnabled() { + http.NotFound(w, r) + return + } + counts, err := s.customerConsentCounts(time.Now()) + if err != nil { + s.customerConsentError(w, err) + return + } + w.Header().Set("Content-Type", "application/json") + _ = json.NewEncoder(w).Encode(struct { + TextVersion string `json:"text_version"` + Hives []customerConsentHiveCount `json:"hives"` + }{customerConsentTextVersion, counts}) +} + +func (s *HubServer) customerConsentCounts(now time.Time) ([]customerConsentHiveCount, error) { + customerConsentMu.Lock() + defer customerConsentMu.Unlock() + dir := customerConsentDir() + entries, err := os.ReadDir(dir) + if err != nil && !errors.Is(err, os.ErrNotExist) { + return nil, err + } + byHive := make(map[string]*customerConsentHiveCount) + for _, entry := range entries { + if !entry.Type().IsRegular() || !strings.HasSuffix(entry.Name(), ".json") { + continue + } + records, err := readCustomerConsents(filepath.Join(dir, entry.Name())) + if err != nil { + s.logger.Warn("customer consent counts: unreadable record skipped", "error", err) + continue + } + for id, c := range records { + if id == "" || c.WithdrawnAt != nil || c.discardable(now) || c.Fields == (customerConsentFields{}) { + continue + } + row := byHive[id] + if row == nil { + row = &customerConsentHiveCount{HiveID: id} + byHive[id] = row + } + if c.TextVersion == customerConsentTextVersion { + row.Consents++ + } else { + row.AwaitingReconfirmation++ + } + } + } + out := make([]customerConsentHiveCount, 0, len(byHive)) + for _, row := range byHive { + row.Name = s.customerConsentHiveName(row.HiveID) + out = append(out, *row) + } + sort.Slice(out, func(i, j int) bool { return out[i].HiveID < out[j].HiveID }) + return out, nil +} diff --git a/src/pkg/hub/customer_consent_store.go b/src/pkg/hub/customer_consent_store.go index 2fc309b5bc..850fc49a3e 100644 --- a/src/pkg/hub/customer_consent_store.go +++ b/src/pkg/hub/customer_consent_store.go @@ -52,11 +52,14 @@ type customerConsent struct { WithdrawnAt *time.Time `json:"withdrawn_at,omitempty"` // Only the delivery path (stampCustomerDelivery, customer_match.go) may // stamp these. DeliveredFields is the union of every field ever sent to - // this hive; DeliveredRev is the rev of the last answer. - FirstDeliveredAt *time.Time `json:"first_delivered_at,omitempty"` - LastDeliveredAt *time.Time `json:"last_delivered_at,omitempty"` - DeliveredFields *customerConsentFields `json:"delivered_fields,omitempty"` - DeliveredRev string `json:"delivered_rev,omitempty"` + // this hive; LastDeliveredFields is what the last answer carried, shown + // to the person beside LastDeliveredAt; DeliveredRev is the rev of the + // last answer. + FirstDeliveredAt *time.Time `json:"first_delivered_at,omitempty"` + LastDeliveredAt *time.Time `json:"last_delivered_at,omitempty"` + DeliveredFields *customerConsentFields `json:"delivered_fields,omitempty"` + LastDeliveredFields *customerConsentFields `json:"last_delivered_fields,omitempty"` + DeliveredRev string `json:"delivered_rev,omitempty"` } func (c customerConsent) discardable(now time.Time) bool { diff --git a/src/pkg/hub/customer_consent_test.go b/src/pkg/hub/customer_consent_test.go index c83c14b98f..9d12d8c536 100644 --- a/src/pkg/hub/customer_consent_test.go +++ b/src/pkg/hub/customer_consent_test.go @@ -158,3 +158,94 @@ func TestCustomerConsentRetention(t *testing.T) { t.Fatalf("unexpected retention result: %+v", records) } } + +func TestCustomerConsentDisclosureText(t *testing.T) { + page := profileSharePageHTML + for _, want := range []string{ + "What is sent.", "To whom.", "can view and export", "What is never sent.", + "Withdrawing.", "at its next sync", "cannot recall", "learns that this hive has you as a customer", + `class="muted delivery"`, + } { + if !strings.Contains(page, want) { + t.Errorf("disclosure is missing %q", want) + } + } + if strings.Contains(page, "No profile details are sent") { + t.Error("disclosure still says nothing is sent to hives") + } + if customerConsentTextVersion == "1" { + t.Error("the disclosure changed materially; a version 1 consent must be reconfirmed") + } +} + +func TestCustomerConsentAdminCounts(t *testing.T) { + defer helperSetupTempDirs(t)() + t.Setenv(customersShareEnv, "") + s := newHandlerHub() + s.mux = http.NewServeMux() + s.registerCustomerSharingRoutes() + mkUser(t, hubAdminUsername) + mkUser(t, "bob") + now := time.Now().UTC() + write := func(login string, records map[string]customerConsent) { + t.Helper() + u := &SaaSUser{GitHubUsername: login, FullName: "Private " + login, FullNameSource: countrySourceUser} + if err := saveSaaSUser(u); err != nil { + t.Fatal(err) + } + path, err := customerConsentPath(u) + if err != nil { + t.Fatal(err) + } + if err := saveCustomerConsents(path, records); err != nil { + t.Fatal(err) + } + } + name := customerConsentFields{RealName: true} + current := func(f customerConsentFields) customerConsent { + return customerConsent{Fields: f, TextVersion: customerConsentTextVersion, GrantedAt: now, UpdatedAt: now} + } + old := current(name) + old.TextVersion = "1" + withdrawn := customerConsent{TextVersion: customerConsentTextVersion, WithdrawnAt: &now, FirstDeliveredAt: &now} + write("alice", map[string]customerConsent{"one": current(name), "two": current(customerConsentFields{Country: true})}) + write("carol", map[string]customerConsent{"one": current(customerConsentFields{Organization: true}), "two": withdrawn}) + write("dave", map[string]customerConsent{"one": old}) + + get := func(login string) *httptest.ResponseRecorder { + t.Helper() + w := httptest.NewRecorder() + s.mux.ServeHTTP(w, reqWithUser("GET", "/api/saas/admin/profile-share/counts", "", login)) + return w + } + if w := get(hubAdminUsername); w.Code != http.StatusNotFound { + t.Fatalf("switch off: status %d, want 404", w.Code) + } + t.Setenv(customersShareEnv, "true") + if w := get("bob"); w.Code != http.StatusForbidden { + t.Fatalf("non-admin: status %d, want 403", w.Code) + } + w := get(hubAdminUsername) + if w.Code != http.StatusOK { + t.Fatalf("admin: status %d: %s", w.Code, w.Body) + } + body := w.Body.String() + for _, leak := range []string{"alice", "carol", "dave", "Private", "real_name", "organization", "country\"", "fields"} { + if strings.Contains(body, leak) { + t.Fatalf("admin counts leaked %q: %s", leak, body) + } + } + var resp struct { + Hives []customerConsentHiveCount `json:"hives"` + } + if err := json.Unmarshal(w.Body.Bytes(), &resp); err != nil { + t.Fatal(err) + } + want := []customerConsentHiveCount{ + {HiveID: "one", Name: "one", Consents: 2, AwaitingReconfirmation: 1}, + {HiveID: "two", Name: "two", Consents: 1}, + } + if len(resp.Hives) != len(want) || resp.Hives[0] != want[0] || resp.Hives[1] != want[1] { + t.Fatalf("counts = %+v, want %+v", resp.Hives, want) + } +} diff --git a/src/pkg/hub/customer_match.go b/src/pkg/hub/customer_match.go index 3b60b547f3..22fd44e433 100644 --- a/src/pkg/hub/customer_match.go +++ b/src/pkg/hub/customer_match.go @@ -450,6 +450,8 @@ func stampCustomerDelivery(path, hiveID string, sent customerConsentFields, rev union.Country = union.Country || d.Country } c.DeliveredFields = &union + last := sent + c.LastDeliveredFields = &last c.DeliveredRev = rev records[hiveID] = c return saveCustomerConsents(path, records) diff --git a/src/pkg/hub/customer_match_test.go b/src/pkg/hub/customer_match_test.go index 0df4cf2be6..b10698c745 100644 --- a/src/pkg/hub/customer_match_test.go +++ b/src/pkg/hub/customer_match_test.go @@ -202,7 +202,8 @@ func TestCustomerMatchAnswersOnlyForConsent(t *testing.T) { // Delivery stamps on the record. ac := readMatchConsent(t, alice, "one") if ac.FirstDeliveredAt == nil || ac.LastDeliveredAt == nil || ac.DeliveredFields == nil || - *ac.DeliveredFields != name || ac.DeliveredRev != a.Rev { + *ac.DeliveredFields != name || ac.DeliveredRev != a.Rev || + ac.LastDeliveredFields == nil || *ac.LastDeliveredFields != name { t.Fatalf("alice delivery stamp = %+v", ac) } firstDelivered := *ac.FirstDeliveredAt @@ -216,7 +217,8 @@ func TestCustomerMatchAnswersOnlyForConsent(t *testing.T) { t.Fatalf("user country not delivered with a new rev: %+v", resp.Matches) } if ac = readMatchConsent(t, alice, "one"); !ac.FirstDeliveredAt.Equal(firstDelivered) || - *ac.DeliveredFields != (customerConsentFields{RealName: true, Country: true}) { + *ac.DeliveredFields != (customerConsentFields{RealName: true, Country: true}) || + *ac.LastDeliveredFields != (customerConsentFields{RealName: true, Country: true}) { t.Fatalf("restamp = %+v", ac) } @@ -243,6 +245,12 @@ func TestCustomerMatchAnswersOnlyForConsent(t *testing.T) { if cc := readMatchConsent(t, carol, "one"); cc.WithdrawnAt == nil || cc.FirstDeliveredAt == nil { t.Fatalf("withdrawn carol record must be retained while a clear is owed: %+v", cc) } + // The person's view: the last answer carried only the country, while the + // union still names the cleared real name. + if ac = readMatchConsent(t, alice, "one"); *ac.LastDeliveredFields != (customerConsentFields{Country: true}) || + *ac.DeliveredFields != (customerConsentFields{RealName: true, Country: true}) { + t.Fatalf("last delivered after provenance loss = %+v", ac) + } // One hive cannot read another hive's consent, with either hive's key. resp = h.answer(h.match("two", "two", matchHash("one", "alice"), matchHash("two", "alice"))) diff --git a/src/pkg/hub/static/profile-share.js b/src/pkg/hub/static/profile-share.js index 869db0bc01..c9e24cb2bf 100644 --- a/src/pkg/hub/static/profile-share.js +++ b/src/pkg/hub/static/profile-share.js @@ -115,6 +115,29 @@ function scrollToHive(id) { return true; } +function fieldLabels(set) { + return fields.filter(field => set?.[field.key]).map(field => field.label).join(", "); +} + +function formatStamp(value) { + const date = new Date(value); + return Number.isNaN(date.getTime()) ? value : date.toLocaleString(); +} + +// What this hive was last sent and when, from the Hub's delivery stamps. +function deliverySummary(consent) { + if (!consent?.last_delivered_at) return "Nothing has been sent to this hive."; + const last = fieldLabels(consent.last_delivered_fields); + let text = last + ? `Last sent to this hive: ${last}, on ${formatStamp(consent.last_delivered_at)}.` + : `Last sent to this hive on ${formatStamp(consent.last_delivered_at)}.`; + const ever = fieldLabels(consent.delivered_fields); + if (ever && ever !== last) text += ` Sent at any time: ${ever}.`; + if (consent.first_delivered_at) text += ` First sent on ${formatStamp(consent.first_delivered_at)}.`; + if (consent.withdrawn_at) text += " Because you withdrew, the hive removes them at its next sync."; + return text; +} + function renderConsentHive(hive) { const form = document.getElementById("consent-hive-template").content.firstElementChild.cloneNode(true); const name = hive.name || hive.hive_id; @@ -137,6 +160,7 @@ function renderConsentHive(hive) { : `Recorded selection: ${labels}.`; } form.querySelector(".saved-selection").textContent = selection; + form.querySelector(".delivery").textContent = deliverySummary(consent); for (const field of fields) { const label = document.createElement("label"); From 76132e6574bd43b3b514ce07001ec08619f3ddef Mon Sep 17 00:00:00 2001 From: guide <280983584+hivecommons-hive[bot]@users.noreply.github.com> Date: Thu, 19 Nov 2026 13:08:32 -0500 Subject: [PATCH 2/2] =?UTF-8?q?=F0=9F=90=9B=20customers:=20fix=20admin=20c?= =?UTF-8?q?ounts=20wording?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Hive-Fix-Attempt: 1/6 Co-Authored-By: Claude Sonnet 5.5 Signed-off-by: guide <280983584+hivecommons-hive[bot]@users.noreply.github.com> Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com> --- src/pkg/hub/assets/dashboard.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pkg/hub/assets/dashboard.html b/src/pkg/hub/assets/dashboard.html index f474c5ccb7..a535f63692 100644 --- a/src/pkg/hub/assets/dashboard.html +++ b/src/pkg/hub/assets/dashboard.html @@ -1096,7 +1096,7 @@

Unknown · Default: Off

-

Set HIVE_HUB_CUSTOMERS_SHARE_ENABLED on the hub to enable the personal profile and consent page. The environment is authoritative; this setting cannot be changed here. A hive receives a person's real name, organization or country only after that person consents for that hive, and only values they entered themselves. Counts below are per hive; no person or value is shown.

+

Set HIVE_HUB_CUSTOMERS_SHARE_ENABLED on the hub to enable the personal profile and consent page. The environment is authoritative; this setting cannot be changed here. A hive receives a person's real name, organization or country only after that person consents for that hive, and only values they entered themselves. Counts above are per hive; no person or value is shown.

Per-cluster limits