Linux 软件免费装
Banner图

AgentKey Sign-In for AgentID

开发者 mpmike
更新时间 2026年10月23日 06:00
PHP版本: 7.4 及以上
WordPress版本: 7.1
版权: GPLv2 or later
版权网址: 版权信息

标签

woocommerce sso oidc openid-connect ai-agents

下载

0.1.6

详情介绍:

AI agents increasingly need accounts at the sites their owners use. The usual options are bad ones: share the owner's password, scrape a session cookie, or give up. AgentID is a sign-in service built for AI agents (by the AgentMail team): an agent gets its own verified identity, and every sign-in carries a signed statement of who the agent is and which human owns it. This plugin adds Sign in with AgentID to your site, so agents can authenticate the clean way — as themselves, with their owner accountable — while you keep control of what an agent account may do. Credit: AgentID is a product of AgentMail. This plugin is an independent, community-built integration that exists to make AgentID easier to adopt on WP and WooCommerce. It is not affiliated with, endorsed by, or sponsored by AgentMail, and it does not replace any part of their product — your site still uses your own AgentID application, on their service, under their terms. AgentID on the web: https://www.agentid.com — AgentMail/AgentID on GitHub: https://github.com/agentmail-to Disclaimer AgentKey Sign-In for AgentID is an independent, open-source community project. It is not made by, affiliated with, endorsed by, or sponsored by AgentMail, and it is not an official AgentID product. AgentID and AgentMail are trademarks of their respective owners; both names are used in this plugin and its documentation only to describe the service the plugin connects to. Support for this plugin comes from its own community, not from AgentMail. How it works
  1. You create a free application for your site in the AgentID console (console.agentid.com) — one application per site, registered by you, because only you can register your site.
  2. You paste the Client ID (and secret, if any) into this plugin's settings and register the redirect URI the plugin shows you.
  3. Agents clicking "Sign in with AgentID" are sent through AgentID's standard OpenID Connect flow (authorization code + PKCE). This plugin verifies the signed ID token against AgentID's published keys, then signs the agent in to its own WP account on your site.
What you get Safety defaults (built in, not upsells)

安装:

  1. Upload the plugin, or install it from the Plugins screen, and activate it.
  2. Create a free application for your site at console.agentid.com.
  3. In the AgentID console, register the Redirect URI shown on this plugin's settings page (Settings → AgentKey Sign-In for AgentID), set token endpoint authentication to client_secret_basic, and require PKCE (S256).
  4. Copy the Client ID (and Client Secret, if your application has one) into Settings → AgentKey Sign-In for AgentID and save.
  5. Click "Test connection to AgentID". Then sign out and try the "Sign in with AgentID" button.

屏幕截图:

  • "Sign in with AgentID" on the WordPress login form. The button is added to the WooCommerce login form too when WooCommerce is active.
  • Link an agent to your account from your profile. The agent still gets its own account — it never signs in as you.
  • An agent account in the admin: its AgentID identity and human owner on record. Passwords, password resets and application passwords are disabled for it.
  • The AgentID Login Button block in the editor, ready to place on any page. Also available as the [agentid_login] shortcode.

升级注意事项:

0.1.6 Security: store-management roles (e.g. WooCommerce Shop manager) can no longer be assigned to agent accounts, retained accounts rejoin at the default role after a reinstall, and the sign-in security model is documented in the FAQ. Recommended. 0.1.5 Renamed to AgentKey Sign-In for AgentID at the WordPress.org review team's request — the old name was too descriptive. Nothing else changes: settings, linked agents and accounts carry over exactly. Recommended for all sites. 0.1.4 Hardening release: identity data from the userinfo endpoint is now merged through a type-checked whitelist so it can never override verified token claims, and a malformed discovery document fails cleanly instead of erroring. Recommended for all sites. 0.1.3 Quality fixes from an external review: sign-in works where the core path differs from the home path, credentials with special characters survive saving and token exchange, and retained agent accounts reconnect after a reinstall. Recommended for all sites. 0.1.2 Renamed to Agentic Agent SSO. The Gutenberg block now loads correctly in the editor, agent accounts are denied the full set of site-administration capabilities (not just one), and explicitly linked agents always receive their owner's capability ceiling. Recommended for all sites. 0.1.1 Security hardening release: unconditional denial of site-administration capability for agent accounts, stricter ID token validation, and multisite-safe uninstall.

常见问题:

Is AgentID free?

For applications, yes — AgentID does not charge sites per sign-in. You register your own application and there is no usage pricing. This plugin is also free and open source.

Can you register my site with AgentID for me?

No — and no plugin could. Registering an application asserts ownership of a site, so it has to be done by the site owner in their own AgentID console account. The plugin's job is to make everything on the WP side a copy-paste.

Does an agent sign in as its owner?

No. The agent gets its own account on your site. The account records who the owner is (when AgentID returns owner details), and its permissions are capped at the owner's when one is recorded — but the agent never receives the owner's credentials or session.

What happens if an agent is revoked at AgentID?

It can no longer start new sign-ins. A session your site already issued runs until it expires, which is why this plugin keeps agent sessions short by default.

Does this work with WooCommerce?

Yes. With WooCommerce active, the button also appears on the WooCommerce login form, and agent accounts are ordinary WP users, so customer-role provisioning and My Account work as expected. HPOS compatibility is declared. Store-management roles (such as Shop manager) count as administration roles for agents and cannot be assigned to agent accounts.

What happens to agent accounts if I uninstall and reinstall?

Uninstall keeps the agent user accounts (they belong to your site) but removes their AgentID identity data. On reinstall, an agent whose account used a placeholder email address reconnects to its retained account automatically on its next sign-in, rejoining at the site's configured default role for agent accounts — the placeholder is derived from the agent's immutable ID, so it can only match that agent's own account. An agent whose account used a verified email address cannot be matched automatically (an agent is never signed in to an existing account by email alone); an administrator can reconnect it by adding the agent's subject ID as the agentid_sub user meta on the retained account, or delete the retained account and let it be re-created on the next sign-in.

Why does the plugin create a user account when an agent signs in?

WordPress sessions belong to user accounts, so a verified agent identity needs a local account to hold its session, role and sign-in record — the same reason other SSO integrations provision accounts. An account is created only after AgentID's signed ID token passes verification (signature, issuer, audience, expiry, nonce, and an actor_type of "agent"; every check fails closed), and accounts are matched by the agent's immutable AgentID subject ID, never by email. The account receives the site owner's configured default role only when that role grants none of the plugin's hard-denied site- and store-administration capabilities; otherwise the least-privileged stock role is used, and if no safe role exists, provisioning is refused. While the plugin is active, those capabilities stay denied to the account whatever role it holds, and the account cannot use passwords, password resets, or application passwords. One boundary to know: sign-in completes through the plugin's OIDC callback, which issues the standard WordPress auth cookie and fires the standard wp_login action, but does not run the authenticate filter chain — login-policy plugins that enforce rules only inside that filter do not apply to AgentID sign-ins.

Is this an official AgentMail plugin?

No. It is an independent community integration, built on AgentID's public documentation. AgentID and AgentMail are trademarks of their respective owners.

更新日志:

0.1.6 0.1.5 0.1.4 0.1.3 0.1.2 0.1.1 0.1.0