Skip to content
KitploitKITPLOIT
OutilsExploitsBlog
Log in
Soumettre
OutilsExploitsBlog
Soumettre

Outils de Hacking, PenTest et Cybersécurité pour votre Arsenal de Sécurité !

Kitploit est un répertoire d'outils de hacking, de cybersécurité et de pentesting. Découvrez les dernières mises à jour des projets pour trouver des vulnérabilités, analyser des systèmes, automatiser les tests et renforcer votre sécurité.

FluxContactConfidentialité© 2026 Kitploit

Répertoire d'outils

Catégories

Voir toutes les catégories
Loading categories
allstar — GitHub App pour définir et appliquer des politiques de sécurité | Kitploit
Outils/GitHubGitHub/ossf/allstar
Outils DéfensifsAudit de ConfigurationSécurité CloudDevSecOpsSécurité de la Chaîne Logistique
GitHubossf/allstar

allstar

GitHub App pour définir et appliquer des politiques de sécurité

Voir le dépôt
1.4k147100il y a 9 joursVérifié par Kitploit
Partager
[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/ossf/allstar/badge)](https://api.scorecard.dev/projects/github.com/ossf/allstar)

<img align="right" src="https://assets.kitploit.com/production/public/readmes/4605/56f8714eef22fa31a6956e341013b069f09b7dd1b45c374eec1e6987c911ed49.png" width="300" height="400">

# **Allstar**

> [!IMPORTANT]
> **L'application GitHub Allstar hébergée par l'OpenSSF a été retirée.**
> Allstar, le sous-projet d'OpenSSF Scorecard, continue d'être
> maintenu — vous devez désormais l'exécuter vous-même, soit
> [en tant que GitHub Action](#running-allstar-as-a-github-action), soit
> [en tant que daemon de service](#running-allstar-as-a-service-daemon).
>
> Consultez [ossf/allstar#881](https://github.com/ossf/allstar/issues/881) pour
> plus de détails.
>
> Si votre organisation dépendait de l'application hébergée, consultez
> [Migrating off the hosted app](#migrating-off-the-hosted-app).

## Vue d'ensemble

-  [Qu'est-ce qu'Allstar ?](#what-is-allstar)

## Nouveautés d'Allstar

- [whats-new.md](https://github.com/ossf/allstar/blob/main/whats-new.md)

## Désactivation des issues indésirables

-  [Au secours ! Allstar crée des issues dont je ne veux pas !](#disabling-unwanted-issues-1)

## Pour commencer

-  [Contexte](#background)
-  [Options au niveau de l'organisation](#org-level-options)
-  [Options d'installation](#installation-options)
    - [Créer votre application GitHub](#create-your-github-app)
    - [Créer votre dépôt de contrôle `.allstar`](#create-your-allstar-control-repository)
    - [Exécuter Allstar en tant que GitHub Action](#running-allstar-as-a-github-action)
    - [Exécuter Allstar en tant que daemon de service](#running-allstar-as-a-service-daemon)
-  [Migrating off the hosted app](#migrating-off-the-hosted-app)

## Politiques et actions
- [Actions](#actions)
- [Politiques](#policies)

## Avancé
- [Définitions de configuration](#configuration-definitions)
- [Exemples de configurations](#example-config-repository)
- [Exécuter votre propre instance d'Allstar](https://github.com/ossf/allstar/blob/main/operator.md)

## Contribuer
- [Contribuer](#contributing)
________
________

## Vue d'ensemble

### Qu'est-ce qu'Allstar ?

Allstar est une application GitHub qui surveille en continu les organisations ou
dépôts GitHub pour vérifier le respect des bonnes pratiques de sécurité. Si Allstar détecte une
violation de politique de sécurité, il crée une issue pour alerter le propriétaire du dépôt ou
de l'organisation. Pour certaines politiques de sécurité, Allstar peut également modifier automatiquement
le paramètre du projet à l'origine de la violation, en le rétablissant dans l'état
attendu.

L'objectif d'Allstar est de vous offrir un contrôle finement ajusté sur les fichiers et paramètres
qui affectent la sécurité de vos projets. Vous pouvez choisir les politiques de sécurité
à surveiller au niveau de l'organisation comme du dépôt, et la manière de
gérer les violations de politique. Vous pouvez également développer ou contribuer de nouvelles politiques.

Allstar est développé dans le cadre du projet [OpenSSF Scorecard](https://github.com/ossf/scorecard).

## [Nouveautés d'Allstar](https://github.com/ossf/allstar/blob/main/whats-new.md)

## Désactivation des issues indésirables
Si vous recevez des issues indésirables créées par Allstar, suivez [ces instructions](https://github.com/ossf/allstar/blob/main/opt-out.md) pour vous désinscrire.

## Pour commencer

### Contexte

Allstar est hautement configurable. Il existe trois principaux niveaux de contrôle :

- **Niveau organisation** : les administrateurs de l'organisation peuvent choisir d'activer Allstar sur :
   -  tous les dépôts de l'organisation ;
   -  la plupart des dépôts, sauf certains qui sont désinscrits ;
   -  seulement quelques dépôts qui sont inscrits.

Ces configurations sont effectuées dans le dépôt `.allstar` de l'organisation.

- **Niveau dépôt :** les mainteneurs de dépôts d'une organisation qui utilise
   Allstar peuvent choisir d'inscrire ou de désinscrire leur dépôt des applications
   au niveau de l'organisation. Remarque : ces contrôles au niveau du dépôt ne fonctionnent que lorsque « repo
   override » est autorisé dans les paramètres au niveau de l'organisation. Ces configurations sont
   effectuées dans le répertoire `.allstar` du dépôt.

- **Niveau politique :** les administrateurs ou mainteneurs peuvent choisir quelles politiques
   sont activées sur des dépôts spécifiques et quelles actions Allstar entreprend lorsqu'une politique
   est violée. Ces configurations sont effectuées dans un fichier yaml de politique, soit dans
   le dépôt `.allstar` de l'organisation (administrateurs), soit dans le répertoire
   `.allstar` du dépôt (mainteneurs).

### Options au niveau de l'organisation

Avant d'installer Allstar au niveau de l'organisation, vous devez décider approximativement sur combien de dépôts vous souhaitez qu'Allstar s'exécute. Cela vous aidera à choisir entre les stratégies Opt-In et Opt-Out.

-  La stratégie Opt In vous permet d'ajouter manuellement les dépôts sur lesquels vous souhaitez qu'Allstar s'exécute. Si vous ne spécifiez aucun dépôt, Allstar ne s'exécutera pas malgré son installation. Choisissez la stratégie Opt In si vous souhaitez appliquer des politiques sur seulement un petit nombre de vos dépôts totaux, ou si vous souhaitez essayer Allstar sur un seul dépôt avant de l'activer sur davantage. Depuis la version v4.3, les globs sont pris en charge pour ajouter facilement plusieurs dépôts portant un nom similaire.

-  La stratégie Opt Out (recommandée) active Allstar sur tous les dépôts et vous permet de sélectionner manuellement les dépôts à exclure des applications d'Allstar. Vous pouvez également choisir d'exclure tous les dépôts publics, ou tous les dépôts privés. Choisissez cette option si vous souhaitez exécuter Allstar sur tous les dépôts d'une organisation, ou si vous souhaitez exclure seulement un petit nombre de dépôts ou un type spécifique (c'est-à-dire public vs privé) de dépôt. Depuis la version v4.3, les globs sont pris en charge pour ajouter facilement plusieurs dépôts portant un nom similaire.

<table>
<thead>
<tr>
<th></th>
<th><strong>Opt Out (Recommandé)</strong><br>
<strong>optOutStrategy = true</strong></th>
<th><strong>Opt In</strong><br>
<strong>optOutStrategy = false</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>Comportement par défaut </td>
<td>Tous les dépôts sont activés</td>
<td>Aucun dépôt n'est activé </td>
</tr>
<tr>
<td>Ajout manuel de dépôts</td>
<td>L'ajout manuel de dépôts désactive Allstar sur ces dépôts</td>
<td>L'ajout manuel de dépôts active Allstar sur ces dépôts</td>
</tr>
<tr>
<td>Configurations supplémentaires</td>
<td>optOutRepos : Allstar sera désactivé sur les dépôts listés<br>
<br>
optOutPrivateRepos : si true, Allstar sera désactivé sur tous les dépôts privés
<br>
<br>
optOutPublicRepos : si true, Allstar sera désactivé sur tous les dépôts
publics<br>
<br>
(optInRepos : ce paramètre sera ignoré)</td>
<td>optInRepos : Allstar sera activé sur les dépôts listés <br>
<br>
(optOutRepos : ce paramètre sera ignoré)</td>
</tr>
<tr>
<td>Remplacement par dépôt </td>
<td>Si true : les dépôts peuvent se soustraire aux applications d'Allstar de leur organisation
en utilisant les paramètres de leur propre fichier de dépôt. Les paramètres d'opt-in au niveau de l'organisation qui
s'appliquent à ce dépôt sont ignorés. <br>
<br>
Si false : les dépôts ne peuvent pas se soustraire aux applications d'Allstar telles que configurées au
niveau de l'organisation. </td>
<td>Si true : les dépôts peuvent s'inscrire aux applications d'Allstar de leur organisation même
s'ils ne sont pas configurés pour le dépôt au niveau de l'organisation. Les paramètres d'opt-out au niveau de l'organisation
qui s'appliquent à ce dépôt sont ignorés.<br>
<br>
Si false : les dépôts ne peuvent pas s'inscrire aux applications d'Allstar s'ils ne sont pas
configurés au niveau de l'organisation. </td>
</tr>
</tbody>
</table>

### Options d'installation

Allstar agit sur votre organisation en tant qu'application GitHub : vous créez l'application, et vous
exécutez le processus qui s'authentifie en son nom. La configuration se fait donc en deux étapes qui sont
communes à tous les déploiements — [créer l'application](#create-your-github-app) et
[créer le dépôt de contrôle](#create-your-allstar-control-repository) — puis un choix sur la façon de l'exécuter :

| | [GitHub Action](#running-allstar-as-a-github-action) | [Démon de service](#running-allstar-as-a-service-daemon) |
|---|---|---|
| **Mode d'exécution** | Tâche planifiée dans votre dépôt `.allstar` | Processus persistant que vous hébergez |
| **Ce que vous fournissez** | Rien au-delà de GitHub | Un serveur ou un orchestrateur de conteneurs |
| **Cadence** | Ce que vous définissez dans le `cron` | Continu, avec des résultats en 5 à 10 minutes |
| **Effort de configuration** | Modéré | Élevé |
| **Idéal lorsque** | Vous souhaitez l'option à moindre infrastructure | Vous souhaitez le plus de contrôle, ou exécutez déjà des services |

L'Action est l'option la moins lourde des deux et c'est par elle que la plupart des organisations
devraient commencer ; vous pourrez passer à un démon plus tard sans modifier aucune configuration de politique.

#### Créer votre application GitHub

Une App est une identité de type utilisateur disposant d'un ensemble de permissions dans votre organisation.
Allstar a besoin d'un accès en lecture à la plupart des paramètres et du contenu des fichiers afin de détecter
la conformité, et d'un accès en écriture aux issues et aux checks afin de créer des issues et de
prendre en charge l'action `block`.

Suivez les [instructions pour l'opérateur - Créer une GitHub
App](https://github.com/ossf/allstar/blob/main/operator.md#create-a-github-app), et enregistrez l'App ID et la clé privée.
Les deux modes d'exécution en ont besoin.

#### Créer votre dépôt de contrôle `.allstar`

Allstar lit sa configuration depuis un dépôt nommé `.allstar` dans votre
organisation.

Le moyen le plus rapide d'en créer un est de partir de l'exemple :

1.  [Ouvrez le dépôt d'exemple](https://github.com/ossf/dot-allstar-quickstart)
    et cliquez sur le bouton « Use this template »
1.  Dans le champ Repository Name, saisissez `.allstar`
1.  Cliquez sur « Create repository from template »

Cela active toutes les [politiques](#policies) Allstar actuelles sur tous les dépôts
en utilisant la stratégie Opt Out, avec l'action `issue`. Vous pouvez modifier tout cela
plus tard.

Pour un contrôle granulaire dès le départ — en choisissant la stratégie Opt In ou Opt Out
et en écrivant vous-même les fichiers de politique individuels — suivez plutôt les [instructions
d'installation manuelle](https://github.com/ossf/allstar/blob/main/manual-install.md).

#### Exécuter Allstar en tant que GitHub Action

Cette option exécute Allstar en tant que tâche planifiée via GitHub Actions, il n'y a donc
aucune infrastructure à exploiter en dehors de GitHub lui-même.

Suivez les [instructions d'installation de GitHub
Actions](https://github.com/ossf/allstar/blob/main/github-action-installation.md) pour configurer une Action récurrente dans votre
dépôt `.allstar`, la durcir et surveiller ses résultats.

#### Exécuter Allstar en tant que démon de service

Cette option exécute Allstar en tant que processus persistant, qui détecte et résout
les violations en continu plutôt que selon une planification.

Consultez les [instructions pour l'opérateur](https://github.com/ossf/allstar/blob/main/operator.md) pour l'exécution du processus, la gestion
des secrets, le dimensionnement et les variables d'environnement disponibles.

### Migrer depuis l'application hébergée

Si votre organisation utilisait l'application hébergée par l'OpenSSF, **votre configuration est
reprise telle quelle**. Le dépôt de contrôle `.allstar`, `allstar.yaml` et chaque
fichier de politique continuent de fonctionner sans modification ; ce que vous remplacez n'est que le processus
qui les lit.

Pour migrer :

1. [Créez votre propre GitHub App](#create-your-github-app) et installez-la sur votre
   organisation avec le même accès aux dépôts que l'application hébergée.
1. Conservez votre dépôt `.allstar` existant exactement tel quel.
1. Exécutez Allstar [en tant qu'Action](#running-allstar-as-a-github-action) ou
   [en tant que démon](#running-allstar-as-a-service-daemon).
1. Désinstallez `allstar-app` de votre organisation, si elle apparaît encore sous
   Settings -> GitHub Apps.

Les issues précédemment créées par l'application hébergée restent dans vos dépôts. Votre propre
instance identifie ses issues par le même label `allstar` (ou votre `issueLabel` configuré),
elle les adoptera donc et les fermera au fur et à mesure de la résolution des violations,
plutôt que de créer des doublons.

## Politiques et Actions

## **Actions**

Chaque politique peut être configurée avec une action qu'Allstar effectuera lorsqu'il
détecte qu'un dépôt n'est pas conforme.

- `log` : C'est l'action par défaut, et elle s'applique en réalité à toutes les
  actions. Tous les résultats et détails d'exécution des politiques sont journalisés. Les logs ne sont actuellement
  visibles que par l'opérateur de l'application, des projets visant à les exposer sont en discussion.
- `issue` : Cette action crée une issue GitHub. Une seule issue est créée par
  politique, et le texte décrit les détails de la violation de politique. Si
  l'issue est déjà ouverte, elle est relancée par un commentaire toutes les 24 heures sans mise à jour
  (non configurable par l'utilisateur actuellement). Si le résultat de la politique change, un nouveau commentaire
  sera laissé sur l'issue et lié dans le corps de l'issue. Une fois la violation
  corrigée, l'issue sera automatiquement fermée par Allstar dans les 5 à 10 minutes.
- `fix` : Cette action est spécifique à chaque politique. La politique effectuera les modifications des
  paramètres GitHub pour corriger la violation de politique. Toutes les politiques ne pourront pas
  prendre en charge cela (voir ci-dessous).

Actions proposées, mais pas encore implémentées. Les définitions seront ajoutées à l'avenir.

- `block` : Allstar peut définir une [GitHub Status
  Check](https://docs.github.com/en/github/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/about-status-checks)
  et bloquer la fusion de toute PR du dépôt si la vérification échoue.
- `email` : Allstar enverrait un e-mail au(x) administrateur(s) du dépôt.
- `rpc` : Allstar enverrait un rpc à un système propre à l'organisation.

### **Configuration de l'action**

Deux paramètres sont disponibles pour configurer l'action issue :

- `issueLabel` est disponible au niveau de l'organisation et du dépôt. Le définir
  remplacera le label `allstar` par défaut utilisé par Allstar pour identifier ses
  issues.

- `issueRepo` est disponible au niveau de l'organisation. Le définir forcera toutes
  les issues créées dans l'organisation à être créées dans le dépôt spécifié.

## **Politiques**

Comme pour la configuration d'activation de l'application Allstar, toutes les politiques sont activées et
configurées avec un fichier yaml dans le dépôt `.allstar` de l'organisation,
ou dans le répertoire `.allstar` du dépôt. Comme pour l'application, les politiques sont opt-in
par défaut, et l'action `log` par défaut ne produira pas de résultats visibles. Un
moyen simple d'activer toutes les politiques est de créer un fichier yaml pour chaque politique avec le contenu :

```yaml
optConfig:
  optOutStrategy: true
action: issue
```

Les détails du fonctionnement de l'action `fix` pour chaque politique sont décrits ci-dessous. Si elle est omise ci-dessous, l'action `fix` n'est pas applicable.

### Branch Protection

Le fichier de configuration de cette politique est nommé `branch_protection.yaml`, et les [définitions de configuration sont ici](https://pkg.go.dev/github.com/ossf/allstar/pkg/policies/branch#OrgConfig).

La politique de protection des branches vérifie que les [paramètres de protection des branches](https://docs.github.com/en/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches) de GitHub sont correctement configurés conformément à la configuration spécifiée. Le texte de l'issue décrira quel paramètre est incorrect. Consultez la [documentation de GitHub](https://docs.github.com/en/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches) pour corriger les paramètres.

L'action `fix` modifiera les paramètres de protection des branches afin qu'ils soient conformes à la configuration de politique spécifiée.

### Binary Artifacts

Le fichier de configuration de cette politique est nommé `binary_artifacts.yaml`, et les [définitions de configuration sont ici](https://pkg.go.dev/github.com/ossf/allstar/pkg/policies/binary#OrgConfig).

Cette politique intègre la [vérification de scorecard](https://github.com/ossf/scorecard/#scorecard-checks). Supprimez l'artefact binaire du dépôt pour atteindre la conformité. Comme les résultats de scorecard peuvent être verbeux, vous devrez peut-être exécuter [scorecard lui-même](https://github.com/ossf/scorecard) pour voir toutes les informations détaillées.

### CODEOWNERS

Le fichier de configuration de cette politique est nommé `codeowners.yaml`, et les [définitions de configuration sont ici](https://pkg.go.dev/github.com/ossf/allstar/pkg/policies/codeowners#OrgConfig).

Cette politique vérifie la présence d'un [fichier `CODEOWNERS`](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners) dans vos dépôts.

### Outside Collaborators

Le fichier de configuration de cette politique est nommé `outside.yaml`, et les [définitions de configuration sont ici](https://pkg.go.dev/github.com/ossf/allstar/pkg/policies/outside#OrgConfig).

Cette politique vérifie si des [collaborateurs externes](https://docs.github.com/en/organizations/managing-access-to-your-organizations-repositories/adding-outside-collaborators-to-repositories-in-your-organization) disposent d'un accès administrateur (par défaut) ou push (facultatif) au dépôt. Seuls les membres de l'organisation devraient avoir cet accès, faute de quoi des membres non fiables peuvent modifier les paramètres de niveau administrateur et committer du code malveillant.

### SECURITY.md

Le fichier de configuration de cette politique est nommé `security.yaml`, et les [définitions de configuration sont ici](https://pkg.go.dev/github.com/ossf/allstar/pkg/policies/security#OrgConfig).

Cette politique vérifie que le dépôt possède un fichier de politique de sécurité dans `SECURITY.md` et que celui-ci n'est pas vide. L'issue créée contiendra un lien vers l'[onglet GitHub](https://docs.github.com/en/code-security/getting-started/adding-a-security-policy-to-your-repository) qui vous aide à committer une politique de sécurité dans votre dépôt.

### Secret Scanning

Le fichier de configuration de cette politique est nommé `secret_scanning.yaml`, et les [définitions de configuration sont ici](https://pkg.go.dev/github.com/ossf/allstar/pkg/policies/secretscanning#OrgConfig).

Cette politique vérifie le paramètre du dépôt GitHub relatif à l'analyse des secrets. Si GitHub signale qu'elle est désactivée, l'issue créée renvoie directement aux paramètres de sécurité du dépôt. Si l'API ne renvoie pas de statut d'analyse des secrets, la politique enregistre que le statut est indisponible plutôt que de le considérer comme désactivé.

L'action `fix` active l'analyse des secrets GitHub pour les dépôts qui ne l'ont pas déjà activée. L'application GitHub Allstar a besoin de la permission d'administration du dépôt pour que l'API GitHub puisse lire ou modifier ce paramètre.

### Dangerous Workflow

Le fichier de configuration de cette politique est nommé `dangerous_workflow.yaml`, et les [définitions de configuration sont ici](https://pkg.go.dev/github.com/ossf/allstar/pkg/policies/workflow#OrgConfig).

Cette politique s'exécutera sur **toutes** les branches, voir la justification [ici](https://github.com/ossf/allstar/issues/569).

Cette politique vérifie les fichiers de configuration des workflows GitHub Actions
(`.github/workflows`) à la recherche de motifs correspondant à des comportements
dangereux connus. Consultez la [documentation OpenSSF Scorecard](https://github.com/ossf/scorecard/blob/main/docs/checks.md#dangerous-workflow)
pour plus d'informations sur cette vérification.

### Vérification générique Scorecard

Le fichier de configuration de cette politique est nommé `scorecard.yaml`, et les [définitions de configuration
se trouvent
ici](https://pkg.go.dev/github.com/ossf/allstar/pkg/policies/scorecard#OrgConfig).

Cette politique exécute toute vérification scorecard listée dans la configuration `checks`. Toutes
les vérifications exécutées doivent avoir un score égal ou supérieur au paramètre `threshold`. Veuillez consulter la
[documentation OpenSSF Scorecard](https://github.com/ossf/scorecard/blob/main/docs/checks.md)
pour plus d'informations sur chaque vérification.

#### Téléversement SARIF

La politique Scorecard peut éventuellement téléverser les résultats au format
[SARIF](https://sarifweb.azurewebsites.net/) dans l'onglet
**Security > Code Scanning** de chaque dépôt. Cela donne aux administrateurs de l'organisation
une visibilité sur les résultats de Scorecard aux côtés d'autres outils de sécurité (CodeQL,
Dependabot, etc.) sans nécessiter de configuration de workflow par dépôt.

Pour activer le téléversement SARIF, ajoutez le champ `upload` à votre fichier `scorecard.yaml` :

```yaml
optConfig:
  optOutStrategy: true
action: issue
checks:
  - Binary-Artifacts
  - Signed-Releases
threshold: 8
upload:
  sarif: true
```

**Prérequis :**
- L'application GitHub Allstar doit disposer de la permission de dépôt **Code scanning alerts** réglée sur **Read & write** (portée API : `security_events`). Cette permission ne fait pas partie de celles dont Allstar a besoin par ailleurs, vous devez donc l'ajouter à votre application avant d'activer l'envoi SARIF.
- L'envoi SARIF est non bloquant : si l'envoi échoue (par exemple en raison de permissions manquantes), la vérification de la politique se poursuit normalement.
- La détection de changements compare le SHA du commit HEAD du dépôt et ignore l'analyse et l'envoi lorsque le dépôt n'a pas reçu de push depuis le dernier envoi.

L'envoi SARIF fonctionne avec les deux modes d'exécution d'Allstar : en tant que [démon de service](https://github.com/ossf/allstar/blob/main/operator.md) ou en tant que [GitHub Action](https://github.com/ossf/allstar/blob/main/github-action-installation.md).

### GitHub Actions

Le fichier de configuration de cette politique s'appelle `actions.yaml`, et les [définitions de configuration se trouvent ici](https://pkg.go.dev/github.com/ossf/allstar/pkg/policies/action#OrgConfig).

Cette politique vérifie les fichiers de configuration des workflows GitHub Actions (`.github/workflows`) (et, dans certains cas, les exécutions de workflows) de chaque dépôt afin de s'assurer qu'ils respectent les règles (par exemple require, deny) définies dans la configuration au niveau de l'organisation pour la politique.

### Repository Administrators

Le fichier de configuration de cette politique s'appelle `admin.yaml`, et les [définitions de configuration se trouvent ici](https://pkg.go.dev/github.com/ossf/allstar/pkg/policies/admin#OrgConfig).

Cette politique vérifie que, par défaut, tous les dépôts doivent avoir un utilisateur ou un groupe désigné comme Administrator. Elle vous permet de configurer en option si les utilisateurs sont autorisés à être administrateurs (par opposition aux équipes).

### Politiques futures

- S'assurer que dependabot est activé.
- Vérifier que les dépendances sont épinglées/figées.

## **Dépôt de configuration d'exemple**

Voir [ce dépôt](https://github.com/GoogleContainerTools/.allstar) comme exemple de configuration Allstar utilisée. En tant qu'administrateur de l'organisation, envisagez un README.md contenant quelques informations sur la façon dont Allstar est utilisé dans votre organisation.

## Avancé

### Définitions de configuration

- [Configuration d'activation au niveau de l'organisation](https://pkg.go.dev/github.com/ossf/allstar/pkg/config#OrgOptConfig)
- [Configuration d'activation de la surcharge au niveau du dépôt]( https://pkg.go.dev/github.com/ossf/allstar/pkg/config#RepoOptConfig)

### Emplacement secondaire de la configuration au niveau de l'organisation

Par défaut, les fichiers de configuration au niveau de l'organisation, tels que le fichier `allstar.yaml` ci-dessus, sont censés se trouver dans un dépôt `.allstar`. Si ce dépôt n'existe pas, le répertoire `allstar` du dépôt `.github` est utilisé comme emplacement secondaire. Pour clarifier, pour `allstar.yaml` :

| Priorité | Dépôt | Chemin |
| - | - | - |
| Primaire | `.allstar` | `allstar.yaml` |
| Secondaire | `.github` | `allstar/allstar.yaml` |

Cela vaut également pour les fichiers de configuration au niveau de l'organisation des politiques individuelles, comme décrit ci-dessous.

### Configurations de politique par dépôt dans le dépôt d'organisation

Allstar recherchera également les configurations de politique au niveau du dépôt dans le dépôt `.allstar` de l'organisation, sous le répertoire portant le même nom que le dépôt. Cette configuration est utilisée que la « surcharge de dépôt » soit désactivée ou non.

Par exemple, Allstar recherchera la configuration de politique d'un dépôt donné `myapp` dans l'ordre suivant :

| Dépôt | Chemin | Condition |
| - | - | - |
| `myapp` | `.allstar/branch_protection.yaml` | Lorsque la « surcharge de dépôt » est autorisée. |
| `.allstar` | `myapp/branch_protection.yaml` | En toutes circonstances. |
| `.allstar` | `branch_protection.yaml` | En toutes circonstances. |
| `.github` | `allstar/myapp/branch_protection.yaml` | Si le dépôt `.allstar` n'existe pas. |
| `.github` | `allstar/branch_protection.yaml` | Si le dépôt `.allstar` n'existe pas. |

### Emplacement de la configuration de base et de fusion au niveau de l'organisation

Pour les fichiers de configuration Allstar et de politique au niveau de l'organisation, vous pouvez spécifier le champ `baseConfig` afin d'indiquer un autre dépôt contenant la configuration Allstar de base. Le mieux est de l'expliquer par un exemple.

Supposons que vous ayez plusieurs organisations GitHub, mais que vous souhaitiez maintenir une seule configuration Allstar. Votre organisation principale est « acme », et le dépôt `acme/.allstar` contient `allstar.yaml` :

```yaml
optConfig:
  optOutStrategy: true
issueLabel: allstar-acme
issueFooter: Issue created by Acme security team.
```

Vous disposez également d'une organisation satellite GitHub nommée « acme-sat ». Vous souhaitez réutiliser la configuration principale, mais y appliquer quelques modifications en désactivant Allstar sur certains dépôts. Le dépôt `acme-sat/.allstar` contient `allstar.yaml` :

```yaml
baseConfig: acme/.allstar
optConfig:
  optOutRepos:
  - acmesat-one
  - acmesat-two
```

Cela utilisera toute la configuration de `acme/.allstar` comme configuration de base, puis appliquera toutes les modifications du fichier courant par-dessus la configuration de base. La méthode appliquée est décrite comme un [JSON Merge Patch](https://datatracker.ietf.org/doc/html/rfc7396). Le `baseConfig` doit être un `<org>/<repository>` GitHub.

## **Contribuer**

Voir [CONTRIBUTING.md](https://github.com/ossf/allstar/blob/main/CONTRIBUTING.md)
Télécharger l’outil

Populaires

Voir tout →

Découvrez les outils les plus utilisés par notre communauté.

Pas encore de données de popularité.

Explorer tous les outils

Parcourez notre collection d'outils

Voir tous les outils →