gws-cloudidentity — команда для Claude Code
Слэш-команда прогоняет операции Google Cloud Identity через Google Workspace CLI: группы, участники, устройства, SSO-профили. Пригодится, когда админские задачи надо решать из чата.
npx claude-code-templates@latest --command google-workspace/gws-cloudidentityЧто делает gws-cloudidentity
Команда подставляет запрос в gws cloudidentity <resource> <method> [flags] и выполняет его от вашего имени. Доступны группы (создание, удаление, поиск, настройки безопасности), участники групп, устройства с командами wipe и cancelWipe, профили OIDC и SAML SSO, назначения SSO и политики. Список ресурсов и методов берётся из gws cloudidentity --help.
Перед вызовом команда проверяет gws --version и gws auth status, затем смотрит схему метода через gws schema cloudidentity.<resource>.<method> — по ней собираются флаги --params и --json. Есть обработка пагинации через --max-results и --page-token и разбор ошибок API с учётом квот.
Без установленного gws и настроенной авторизации ничего не заработает: gws auth status должен показывать рабочую сессию. Для создания устройства нужна одна из лицензий Enterprise Standard, Enterprise Plus, Enterprise for Education или Cloud Identity Premium — остальным метод недоступен. Вход в файл ../gws-shared/SKILL.md обязателен; если его нет, команда советует выполнить gws generate-skills.
Какие задачи решает
- завести группу и раздать в неё участников
- найти группу по имени или ключу сущности
- погасить данные на корпоративном устройстве удалённо
- отменить начатую очистку устройства
- посмотреть профили SAML или OIDC перед настройкой SSO
Примеры запросов агенту
gws-cloudidentity groups list --params '{"parent":"customers/my_customer"}'- Через gws-cloudidentity создай группу devops и добавь в неё двух участников
gws-cloudidentity devices wipe --params '{"name":"devices/123"}'
Как установить gws-cloudidentity
1Через claude-code-templates
npx claude-code-templates@latest --command google-workspace/gws-cloudidentity2Вручную: положить файлы
.claude/commands/gws-cloudidentity.mdВызов — /gws-cloudidentity. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/gws-cloudidentity.mdВызов — /prompts:gws-cloudidentity. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/gws-cloudidentity.prompt.mdВручную: положить файлы
.gemini/commands/gws-cloudidentity.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о gws-cloudidentity
Как установить gws-cloudidentity в Claude Code?
Выполните npx claude-code-templates@latest --command google-workspace/gws-cloudidentity, после этого файл команды появится по пути .claude/commands/gws-cloudidentity.md.
Что делает gws-cloudidentity?
Обёртка над Google Workspace CLI, которая по вашему описанию вызывает методы Cloud Identity API: управляет группами, участниками, устройствами и SSO-профилями.
Что нужно для работы команды?
Установленный gws и настроенная авторизация — проверить можно через gws auth status. Также нужен файл ../gws-shared/SKILL.md с правилами аутентификации и глобальными флагами.
Исходный текст
gws-cloudidentity.md · MIT
---
allowed-tools: Bash, Read, Write, Edit
argument-hint: "[resource] [method] [flags]"
description: "Google Cloud Identity: Manage identity groups and memberships."
---
# Google Workspace Cloudidentity
Execute Google Workspace Cloudidentity operations: $ARGUMENTS
## Prerequisites
- Google Workspace CLI (`gws`) must be installed
- Authentication configured: Run `gws auth status` to verify
- Review `gws cloudidentity --help` for all available commands
## Available Resources and Methods
# cloudidentity (v1)
> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
```bash
gws cloudidentity <resource> <method> [flags]
```
## API Resources
### customers
- `userinvitations` — Operations on the 'userinvitations' resource
### devices
- `cancelWipe` — Cancels an unfinished device wipe. This operation can be used to cancel device wipe in the gap between the wipe operation returning success and the device being wiped. This operation is possible when the device is in a "pending wipe" state. The device enters the "pending wipe" state when a wipe device command is issued, but has not yet been sent to the device. The cancel wipe will fail if the wipe command has already been issued to the device.
- `create` — Creates a device. Only company-owned device may be created. **Note**: This method is available only to customers who have one of the following SKUs: Enterprise Standard, Enterprise Plus, Enterprise for Education, and Cloud Identity Premium
- `delete` — Deletes the specified device.
- `get` — Retrieves the specified device.
- `list` — Lists/Searches devices.
- `wipe` — Wipes all data on the specified device.
- `deviceUsers` — Operations on the 'deviceUsers' resource
### groups
- `create` — Creates a Group.
- `delete` — Deletes a `Group`.
- `get` — Retrieves a `Group`.
- `getSecuritySettings` — Get Security Settings
- `list` — Lists the `Group` resources under a customer or namespace.
- `lookup` — Looks up the [resource name](https://cloud.google.com/apis/design/resource_names) of a `Group` by its `EntityKey`.
- `patch` — Updates a `Group`.
- `search` — Searches for `Group` resources matching a specified query.
- `updateSecuritySettings` — Update Security Settings
- `memberships` — Operations on the 'memberships' resource
### inboundOidcSsoProfiles
- `create` — Creates an InboundOidcSsoProfile for a customer. When the target customer has enabled [Multi-party approval for sensitive actions](https://support.google.com/a/answer/13790448), the `Operation` in the response will have `"done": false`, it will not have a response, and the metadata will have `"state": "awaiting-multi-party-approval"`.
- `delete` — Deletes an InboundOidcSsoProfile.
- `get` — Gets an InboundOidcSsoProfile.
- `list` — Lists InboundOidcSsoProfile objects for a Google enterprise customer.
- `patch` — Updates an InboundOidcSsoProfile. When the target customer has enabled [Multi-party approval for sensitive actions](https://support.google.com/a/answer/13790448), the `Operation` in the response will have `"done": false`, it will not have a response, and the metadata will have `"state": "awaiting-multi-party-approval"`.
### inboundSamlSsoProfiles
- `create` — Creates an InboundSamlSsoProfile for a customer. When the target customer has enabled [Multi-party approval for sensitive actions](https://support.google.com/a/answer/13790448), the `Operation` in the response will have `"done": false`, it will not have a response, and the metadata will have `"state": "awaiting-multi-party-approval"`.
- `delete` — Deletes an InboundSamlSsoProfile.
- `get` — Gets an InboundSamlSsoProfile.
- `list` — Lists InboundSamlSsoProfiles for a customer.
- `patch` — Updates an InboundSamlSsoProfile. When the target customer has enabled [Multi-party approval for sensitive actions](https://support.google.com/a/answer/13790448), the `Operation` in the response will have `"done": false`, it will not have a response, and the metadata will have `"state": "awaiting-multi-party-approval"`.
- `idpCredentials` — Operations on the 'idpCredentials' resource
### inboundSsoAssignments
- `create` — Creates an InboundSsoAssignment for users and devices in a `Customer` under a given `Group` or `OrgUnit`.
- `delete` — Deletes an InboundSsoAssignment. To disable SSO, Create (or Update) an assignment that has `sso_mode` == `SSO_OFF`.
- `get` — Gets an InboundSsoAssignment.
- `list` — Lists the InboundSsoAssignments for a `Customer`.
- `patch` — Updates an InboundSsoAssignment. The body of this request is the `inbound_sso_assignment` field and the `update_mask` is relative to that. For example: a PATCH to `/v1/inboundSsoAssignments/0abcdefg1234567&update_mask=rank` with a body of `{ "rank": 1 }` moves that (presumably group-targeted) SSO assignment to the highest priority and shifts any other group-targeted assignments down in priority.
### policies
- `get` — Get a policy.
- `list` — List policies.
## Discovering Commands
Before calling any API method, inspect it:
```bash
# Browse resources and methods
gws cloudidentity --help
# Inspect a method's required params, types, and defaults
gws schema cloudidentity.<resource>.<method>
```
Use `gws schema` output to build your `--params` and `--json` flags.
## Usage
```bash
# List available resources and methods
gws cloudidentity --help
# Inspect method schema before calling
gws schema cloudidentity.<resource>.<method>
# Execute command with arguments
gws cloudidentity $ARGUMENTS
```
## Task
Execute the requested Cloudidentity operation: $ARGUMENTS
1. **Verify Prerequisites**
- Check `gws` is installed: `gws --version`
- Verify authentication: `gws auth status`
- Review available commands: `gws cloudidentity --help`
2. **Inspect Method Schema**
- Before calling any method, inspect its parameters
- Use `gws schema` to understand required fields
- Review parameter types and constraints
3. **Execute Operation**
- Build command with appropriate flags
- Use `--params` for query/path parameters
- Use `--json` for request body
- Handle pagination with `--max-results` or `--page-token`
4. **Error Handling**
- Check command output for errors
- Review API quotas and rate limits
- Handle authentication issues
- Retry transient failures
---
**License**: Apache License 2.0
**Source**: [Google Workspace CLI](https://github.com/googleworkspace/cli)
**Original Skill**: `gws-cloudidentity`
© davila7 · MIT · davila7/claude-code-templates