Skip to main content

Adding OAuth Authentication

Use the proxy-app-setup skill to integrate @invent/proxy-app-components into your widget — the library that handles OAuth authentication with third-party providers and proxied API calls through Invent's YARP proxy. Instead of wiring up the components by hand, ask Claude and the skill sets up the auth flow for you.

Doing it by hand?

For the manual wiring and a breakdown of the @invent/proxy-app-components API, see Advanced Features → Adding OAuth Authentication.

Install​

In Claude Code (start it by running claude in your terminal first if it isn't already open), run:

/plugin install proxy-app-setup@invent-skills

This is a Claude Code slash command — not a shell command. It only works at the Claude Code prompt.

Add authentication to your widget​

Make sure your terminal's working directory is the widget's project root, then start Claude Code there:

cd path/to/your-widget
claude

At the Claude Code prompt, describe what you need in natural language. For example:

add proxy authentication for the Outlook provider to this widget
wrap this widget with ProxyApp so users have to connect before it loads

These are natural-language requests to Claude — not shell commands.

What the skill sets up​

The skill integrates @invent/proxy-app-components and configures the pieces needed for a working auth flow:

  • ProxyApp / ProxyAppMulti — wraps your widget so it renders the login prompt when the user isn't authenticated and your component once they are. ProxyAppMulti is used when a provider needs to support multiple accounts.
  • Provider auth — points the flow at the right provider and Invent's PEA authentication endpoint.
  • proxyCall — the authenticated request helper for calling the third-party service on the user's behalf.
  • Error handling and SharedFooter — the standard error states and footer used by proxy-backed widgets.

Background​

For a conceptual overview of the end-user flow and the different integration approaches (ProxyApp, ProxyAppMulti, ProxyLogin), see OAuth Integration. The full manual, code-level walkthrough lives in the legacy Proxy App Component tutorial.