PHPackages jasonmccallister/hasura - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. jasonmccallister/hasura AbandonedArchivedCraft-plugin[API Development](/categories/api) jasonmccallister/hasura ======================= Use your Craft CMS credentials to authenticate with a GraphQL API powered by Hasura.io v1.2.0(5y ago)7572[2 issues](https://github.com/jasonmccallister/craft-hasura/issues)[5 PRs](https://github.com/jasonmccallister/craft-hasura/pulls)MITPHP Since Mar 27Pushed 3y agoCompare [ Source](https://github.com/jasonmccallister/craft-hasura)[ Packagist](https://packagist.org/packages/jasonmccallister/hasura)[ RSS](/packages/jasonmccallister-hasura/feed)WikiDiscussions master Synced 2w ago READMEChangelog (4)Dependencies (2)Versions (9)Used By (0) Hasura ====== [](#hasura) Use your Craft CMS credentials to authenticate with a GraphQL API powered by Hasura.io [![Hasura Logo](resources/img/plugin-logo.png)](resources/img/plugin-logo.png) Requirements ------------ [](#requirements) This plugin requires Craft CMS 3.5.0 or later. Installation ------------ [](#installation) To install the plugin, follow these instructions. 1. Open your terminal and go to your Craft project: ``` cd /path/to/project ``` 2. Then tell Composer to load the plugin: ``` composer require jasonmccallister/hasura ``` 3. In the Control Panel, go to Settings → Plugins and click the “Install” button for Hasura. Hasura Overview --------------- [](#hasura-overview) Hasura.io is an open-source tool that makes building APIs with real-time GraphQL APIs without writing *any code*. Hasura lets you connect to a new, or existing, PostgreSQL database and automatically build a GraphQL schema with real-time subscriptions; all with out writing any code! This allows you to build GraphQL APIs at scale, with no code, using only a database and Docker image! *Watch this video as the Hasura team takes a complex applications database (in the example it uses the Gitlab database) and drops it into GraphQL in under 4 minutes* [![Instant GraphQL on GitLab](https://camo.githubusercontent.com/296c624f8d3d66612d8fc951b14cdeebb058f6c02e10d44c38239c205fd305ec/68747470733a2f2f692e7974696d672e636f6d2f76692f61324168784b71643832512f6d617872657364656661756c742e6a7067)](https://www.youtube.com/watch?v=a2AhxKqd82Q) Out of the box, Hasura comes with: 1. Automatic Schema generation including nested relationships 2. GraphQL queries & mutations based on your database 3. Subscription support allowing realtime UI updates 4. Remote schemas allowing you to combine multiple GraphQL APIs 5. Migrations for new projects 6. Event trigger based on database actions (insert, updates, and deletes) 7. Dynamic access roles and authentication However, Hasura can be configured to accept JWTs that are signed in a specific format. This is where the Hasura plugin helps. This plugin allows you to use your Craft CMS users and groups to generate the JWT to send to your Hasura API. Configuring Hasura ------------------ [](#configuring-hasura) After installation, you need to set a few items in the plugins settings: 1. Enable or disable CSRF (if external applications will use this endpoint for JWTs you need to disable CSRF) 2. Set the signing method on the JWT that the Hasura API expects (RS256 or etc) 3. Enter the key (string or private token) Using Craft CMS as Authentication for Hasura -------------------------------------------- [](#using-craft-cms-as-authentication-for-hasura) Users will authenticate with their username (or email if Craft is configured for email) and password to `https://yourdomain.com/hasura/auth` ### Example Response [](#example-response) ``` { "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIwNGZjNDM5Mi0wMmNlLTQ3MTgtYmQ5My03ODhjMWI1ZTU1ZjQiLCJhZG1pbiI6dHJ1ZSwiaWF0IjoxNTUzMDc5MjY5LCJleHAiOjE1NTMwODI4NjksImh0dHBzOlwvXC9oYXN1cmEuaW9cL2p3dFwvY2xhaW1zIjp7IngtaGFzdXJhLWFsbG93ZWQtcm9sZXMiOlsidXNlciIsImFkbWluIl0sIngtaGFzdXJhLWRlZmF1bHQtcm9sZSI6ImFkbWluIiwieC1oYXN1cmEtdXNlci1pZCI6IjA0ZmM0MzkyLTAyY2UtNDcxOC1iZDkzLTc4OGMxYjVlNTVmNCJ9fQ.WEAFZYon5arnCTN9ecAEiG4dKl-jkyk3em8EpJ9N0Vs" } ``` ### Example JWT [](#example-jwt) ``` { "sub": "04fc4392-02ce-4718-bd93-788c1b5e55f4", "admin": true, "iat": 1553079269, "exp": 1553082869, "https://hasura.io/jwt/claims": { "x-hasura-allowed-roles": ["user", "admin"], "x-hasura-default-role": "admin", "x-hasura-user-id": "04fc4392-02ce-4718-bd93-788c1b5e55f4" } } ``` Configuring Craft CMS to Handle Event Trigger Webhooks from Hasura ------------------------------------------------------------------ [](#configuring-craft-cms-to-handle-event-trigger-webhooks-from-hasura) Hasura allows you to tie events to table actions like insert, update, and delete. These are known as [Event Triggers](https://hasura.io/event-triggers). This plugin allows you to receive those event triggers by configuring Hasura to send to your Craft CMS. `https://yourdomain.com/hasura/webhook` You can configure the header that Hasura will send in the plugin settings as well as a key. When the event trigger payload is received, the plugin will fire the `hasuraEventTrigger` event and allow you to listen for the event and take action. The event contains the following: - table: The name of the table the event came from (e.g. `todos`) - trigger: The name of the trigger (e.g. `send_updated_todo_to_craft`) - payload: The payload of the event, which is [contains the new and old data](https://docs.hasura.io/1.0/graphql/manual/event-triggers/payload.html#json-payload) (based on the trigger type) Brought to you by [Jason McCallister](https://mccallister.io) Add Custom Claims via Twig field in Plugin Settings --------------------------------------------------- [](#add-custom-claims-via-twig-field-in-plugin-settings) You can add custom claims (for example the users name or a custom field) to the JWT token via the new Custom Claims field in the Plugin settings. You can add any additional information as well as user specific details as he field accepts the `user` variable. In Hasura you are then able to write rules based on the `x-hasura-custom-claim` object. ### Example twig query [](#example-twig-query) ``` {{user.fullName}} ``` ### Example JWT [](#example-jwt-1) ``` { "sub": "04fc4392-02ce-4718-bd93-788c1b5e55f4", "admin": true, "iat": 1553079269, "exp": 1553082869, "https://hasura.io/jwt/claims": { "x-hasura-allowed-roles": ["user", "admin"], "x-hasura-default-role": "admin", "x-hasura-user-id": "04fc4392-02ce-4718-bd93-788c1b5e55f4", "x-hasura-custom-claim": "John Doe" } } ``` Current limitation for custom claim arrays ------------------------------------------ [](#current-limitation-for-custom-claim-arrays) As Hasura only accepts custom claims to be strings we need to unwrap arrays and add them as single claims. The plugin does this for you but only on the first level. Recursive mapping will be added later. More infos can be found here: [hasura/graphql-engine#1902](https://github.com/hasura/graphql-engine/issues/1902) ### Example twig query returning an object/array [](#example-twig-query-returning-an-objectarray) ``` {% set customCategory = user.customCategory.one() %} {% if customCategory %} {% set jsonObject = { "user-name": user.fullName, "category-uid": customCategory, "category-title": customCategory, "category-slug": customCategory } %} {{ jsonObject | json_encode() }} {% endif %} ``` ### Example JWT [](#example-jwt-2) ``` { "sub": "04fc4392-02ce-4718-bd93-788c1b5e55f4", "admin": true, "iat": 1553079269, "exp": 1553082869, "https://hasura.io/jwt/claims": { "x-hasura-allowed-roles": ["user", "admin"], "x-hasura-default-role": "admin", "x-hasura-user-id": "04fc4392-02ce-4718-bd93-788c1b5e55f4", "x-hasura-custom-user-name": "John Doe", "x-hasura-custom-category-uid": "071cd618-e675-4bcc-b362-0311b43333c9", "x-hasura-custom-category-title": "Category Name", "x-hasura-custom-category-slug": "category-name" } } ``` ### Health Score 29 — LowBetter than 57% of packages Maintenance14 Infrequent updates — may be unmaintained Popularity15 Limited adoption so far Community10 Small or concentrated contributor base Maturity66 Established project with proven stability Bus Factor1 Top contributor holds 76.9% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~289 days Total 3 Last Release 2073d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/d3727a5febf036e01928d7ab7b650fe7528e117255449ade6b34dff7142ef56f?d=identicon)[themccallister](/maintainers/themccallister) --- Top Contributors [![jasonmccallister](https://avatars.githubusercontent.com/u/5354908?v=4)](https://github.com/jasonmccallister "jasonmccallister (40 commits)")[![denisyilmaz](https://avatars.githubusercontent.com/u/4189607?v=4)](https://github.com/denisyilmaz "denisyilmaz (12 commits)") --- Tags apicraftcraftcmsgraphqlhasuraplugincmsCraftcraftcmscraft-pluginhasura ### Embed Badge ![Health badge](/badges/jasonmccallister-hasura/health.svg) ``` [![Health](https://phpackages.com/badges/jasonmccallister-hasura/health.svg)](https://phpackages.com/packages/jasonmccallister-hasura) ``` ### Alternatives [verbb/formie The most user-friendly forms plugin for Craft. 102393.6k59](/packages/verbb-formie)[wrav/oembed A simple plugin to extract media information from websites, like youtube videos, twitter statuses or blog articles. 36207.2k3](/packages/wrav-oembed)[verbb/hyper A user-friendly links field for Craft. 24147.8k12](/packages/verbb-hyper)[craftpulse/craft-typesense Craft Plugin that synchronises with Typesense 122.7k](/packages/craftpulse-craft-typesense) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)