Takumi Agent for Endpoint
The English user guide is currently in beta preview. Most of the documents have been automatically translated from the Japanese version. Should you find any inaccuracies, please reach out to Flatt Security.
Takumi Agent for Endpoint protects your organization's Macs with Takumi Guard. It works through Takumi Agent, an endpoint agent installed on each Mac. The agent enrolls each Mac in your Shisho Cloud organization, reports the device's protection state to the console, and updates itself. Its first capability is Takumi Guard: the agent captures traffic to the supported public package registries at the network layer and sends it through Takumi Guard, whichever tool sent it and however that tool is configured.
Takumi Agent for Endpoint requires an active Takumi subscription with the Guard protection feature enabled. See Pricing & Billing for details.
What the agent does
Besides running Takumi Guard, the agent handles the device itself:
- Enrollment: an enrollment key registers the Mac as a device in your organization.
- State reporting: the Mac reports whether it is protected, shown in the menu bar and in the console.
- Updates: new releases install in the background on every device.
- Diagnostics: the user can copy diagnostics or send them to your organization for an administrator to read in the console.
- Tamper evidence: when the device's own health reporting is interfered with, the evidence stays until an administrator acknowledges it.
What is covered
Takumi Agent covers all five Guard ecosystems by capturing their public registries:
| Ecosystem | Registries |
|---|---|
| npm (incl. Yarn) | registry.npmjs.org, registry.npmjs.com, registry.yarnpkg.com |
| PyPI | pypi.org, files.pythonhosted.org |
| RubyGems | rubygems.org, index.rubygems.org |
| Go modules | proxy.golang.org |
| Packagist (Composer) | repo.packagist.org, packagist.org, and the packagist.jp and packagist.kr mirrors |
Connections to other hosts pass through untouched: private registries and other mirrors, Git and tarball URLs, and Go modules fetched straight from version control (GOPROXY=direct, GOPRIVATE).
Takumi Agent inspects only connections to the supported registries. Every other connection passes through and is never decrypted. Blocklists and policy stay in Takumi Guard, so the Mac makes no security decisions of its own. How Takumi Agent works explains the design.