genai-docs/Sync SWA roles with GitHub repo permissions

swa-github-role-sync syncs Azure Static Web Apps and GitHub roles by posting invitation links to Discussions.

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Stale
License
None
namedescriptionrequireddefault
github-tokenGitHub token with permissions to read collaborators and create discussions.yes
target-repoTarget repository in owner/repo format. Defaults to the current repository.no
swa-nameName of the target Azure Static Web App.yes
swa-resource-groupResource group name of the Static Web App.yes
swa-domainDomain of the Static Web App (e.g. your-app.azurestaticapps.net). Used for invite links.no
invitation-expiration-hoursInvitation link expiration in hours (1-168).no168
minimum-permissionMinimum GitHub permission level to sync. Options: read, triage, write, maintain, admin.nowrite
role-for-adminSWA role name assigned to GitHub admin users.nogithub-admin
role-for-maintainSWA role name assigned to GitHub maintain users.nogithub-maintain
role-for-writeSWA role name assigned to GitHub write users.nogithub-write
role-for-triageSWA role name assigned to GitHub triage users.nogithub-triage
role-for-readSWA role name assigned to GitHub read users.nogithub-read
role-prefixPrefix used to detect SWA roles managed by this action.nogithub-
discussion-category-nameDiscussion category name where invite summary Discussion will be created.yes
discussion-title-templateTemplate for discussion title. Placeholders: {swaName}, {repo}, {date}, {login}.noSWA access invite for @{login} ({swaName}) - {date}
discussion-body-templateTemplate for discussion body. Placeholders: {swaName}, {repo}, {summaryMarkdown}, {login}, {role}, {inviteUrl}, {invitationExpirationHours}. noHi @{login}, You now have **{role}** access to **{swaName}** from **{repo}**. - Invite link: {inviteUrl} - Role: {role} - Expires in: {invitationExpirationHours} hours Use the invite link above to authenticate. After you confirm access, close this discussion so the admins know you're done. If the invite expired, comment here and we'll re-run the sync.
namedescription
added-countNumber of users newly invited on SWA.
updated-countNumber of users whose SWA roles were updated.
removed-countNumber of users removed from SWA roles.
discussion-urlURL of the first created Discussion (kept for backward compatibility).
discussion-urlsNewline-separated URLs of every invite Discussion (empty when no invites).