Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 9 additions & 8 deletions docs/content/best-practices/adoption-patterns.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,13 @@ import {

# <ProductName format={ProductNameFormat.ShortForm}/> Adoption Patterns

This document outlines key implementation patterns for adopting <ProductName format={ProductNameFormat.ShortForm}/> in your organization.
In general, when adopting <ProductName format={ProductNameFormat.ShortForm}/>, you need to deal with three main challenges:

- Define an authorization model that reflects your business requirements.
- Implement a data pipeline that keeps the data in <ProductName format={ProductNameFormat.ShortForm}/> up to date.
- Integrate <ProductName format={ProductNameFormat.ShortForm}/> into your applications using the APIs or SDKs.

This document outlines a few patterns for addressing these issues when implementing <ProductName format={ProductNameFormat.ShortForm}/> in your organization.

## Starting with coarse-grained access control

Expand Down Expand Up @@ -155,7 +161,7 @@ Some companies decide to wrap <ProductName format={ProductNameFormat.ShortForm}/
- If they are using Contextual Tuples, they can keep the logic to retrieve additional data to send to <ProductName format={ProductNameFormat.ShortForm}/> in a single service.
- They only need to provide <ProductName format={ProductNameFormat.ShortForm}/> configuration data like Store ID and Model ID in a single service.

On the other hand, adding another service increases latency, adds additional complexity and would make the teams less likely to find help from existing public OpenFGA documentation and resources.
On the other hand, adding another service increases latency, adds additional complexity and would make the teams less likely to find help from existing public documentation and resources.

## Shadowing the <ProductName format={ProductNameFormat.ShortForm}/> API

Expand All @@ -180,13 +186,8 @@ This pattern is particularly useful for critical systems where authorization err
## Related Sections

<RelatedSection
description="Check out these related resources for more information about adopting OpenFGA"
description="Check out these related resources for more information about adopting FGA"
relatedLinks={[
{
title: 'Running OpenFGA in Production',
description: 'Learn about best practices for running OpenFGA in production environments.',
link: './running-in-production',
},
{
title: 'Modular Authorization Models',
description: 'Learn how to break down your authorization model into modules.',
Expand Down
Loading