Skip to content
align-center

GitHub Action

OpenFGA Model Deploy Action

v0.1.1 Latest version

OpenFGA Model Deploy Action

align-center

OpenFGA Model Deploy Action

Github Action for deploying your Authorization Model to an OpenFGA Store

Installation

Copy and paste the following snippet into your .yml file.

              

- name: OpenFGA Model Deploy Action

uses: openfga/[email protected]

Learn more about this action in openfga/action-openfga-deploy

Choose a version

OpenFGA Github Action - Deploy

FOSSA Status

This action can be used to deploy your authorization model to an OpenFGA store.

Parameter

Parameter Required/Optional Description
api-url Required The URL to your OpenFGA server
api-token Required The token used to when preshared keys are used to authenticate the OpenFGA server
store-id Required The store to which the model should be deployed
model-file-path Optional The path to your model file relative to the root of your project
model Optional The model value if file is not used, Ensure it is character escaped.
format Optional Authorization model input format. Can be "fga" or "json", defaults to auto-detecting from the file extension

Outputs

Output Description
authorization_model_id The ID of the deployed Authorization Model

Example

name: Deploy Action

on:
  workflow_dispatch:

jobs:
  deploy:
    name: Deploy Authorization Model
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Deploy using a file
        uses: openfga/[email protected]
        with:
          api-url: http://localhost:8080
          api-token: ${{ secrets.KEY }}
          store-id: ${{ env.STORE_ID }}
          model-file-path: ./example/model.fga
      - name: Deploy using a string
        uses: openfga/[email protected]
        with:
          api-url: http://localhost:8080
          api-token: ${{ secrets.KEY }}
          store-id: ${{ env.STORE_ID }}
          format: json
          model: '{\"schema_version\":\"1.1\",\"type_definitions\":\[\{\"type\":\"user\"\},\{\"type\":\"document\",\"relations\":\{\"reader\":\{\"this\":\{\}\},\"writer\":\{\"this\":\{\}\},\"owner\":\{\"this\":\{\}\}\},\"metadata\":\{\"relations\":\{\"reader\":\{\"directly_related_user_types\":\[\{\"type\":\"user\"\}\]\},\"writer\":\{\"directly_related_user_types\":\[\{\"type\":\"user\"\}\]\},\"owner\":\{\"directly_related_user_types\":\[\{\"type\":\"user\"\}\]\}\}\}\}\]\}'

License

FOSSA Status