Skip to main content

Enterprise Server 3.15 est actuellement disponible en tant que version finale (RC).

Accès aux rapports pour votre instance

Vous pouvez télécharger des rapports avec des informations sur les utilisateurs, les organisations et les référentiels sur votre instance GitHub Enterprise Server.

Qui peut utiliser cette fonctionnalité ?

Enterprise owners can download reports for a GitHub Enterprise Server instance.

À propos des rapports pour GitHub Enterprise Server

Si vous avez besoin d’obtenir des informations à propos des utilisateurs, des organisations et des référentiels sur votre instance GitHub Enterprise Server, vous pouvez récupérer des données via l’API REST. Pour plus d’informations, consultez « Informations sur l’API REST ».

L’API REST peut ne pas vous fournir toutes les données que vous souhaitez. Cette API requiert une certaine expertise technique pour être utilisée. Vous pouvez également utiliser des rapports contenant des vues d’ensemble des utilisateurs, des organisations et des référentiels présents sur votre instance.

Téléchargement de rapports à l’aide de l’interface utilisateur web

  1. À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur en haut à droite de n’importe quelle page.
  2. Dans la barre latérale gauche, cliquez sur Rapports.
  3. En regard du rapport que vous souhaitez télécharger, cliquez sur Télécharger.

Vous pouvez télécharger des fichiers CSV qui signalent les informations suivantes :

  • Tous les utilisateurs
  • Tous les utilisateurs actifs
  • Tous les utilisateurs dormants
  • Tous les utilisateurs suspendus
  • Toutes les organisations
  • Tous les référentiels

Téléchargement de rapports par programmation

Vous pouvez également accéder aux rapports par programmation via l’authentification HTTP standard et via un personal access token (classic). Vous devez utiliser un personal access token (classic) avec l’étendue site_admin. Pour plus d’informations, consultez « Gestion de vos jetons d'accès personnels ».

Par exemple, vous pouvez télécharger le rapport « tous les utilisateurs » à l’aide de cURL :

curl --remote-name \
     --location \
     --user 'USERNAME:TOKEN' \
     http(s)://HOSTNAME/stafftools/reports/all_users.csv

Pour accéder aux autres rapports par programmation, remplacez all_users par active_users, dormant_users, suspended_users, all_organizations ou all_repositories.

Note

La demande initiale retourne une réponse HTTP 202 si aucun rapport mis en cache n’est disponible. Votre instance génère alors un rapport en arrière-plan. Vous pouvez envoyer une deuxième demande pour télécharger le rapport. Vous pouvez utiliser un mot de passe ou un jeton OAuth avec l’étendue site_admin à la place d’un mot de passe.

Rapports utilisateur

CléDescription
created_atDate/heure de création du compte d’utilisateur (horodatage ISO 8601)
idID de compte de l’utilisateur ou de l’organisation
loginNom de connexion du compte
emailAdresse e-mail principale du compte
roleIndique si le compte est de type administrateur ou utilisateur ordinaire
suspended?Indique si le compte a été suspendu
last_logged_ipDernière adresse IP à s’être connectée au compte
reposNombre de dépôts dont le compte est propriétaire
ssh_keysNombre de clés SSH inscrites au niveau du compte
org_membershipsNombre d’organisations auxquelles le compte appartient
dormant?Indique si le compte est dormant
last_activeDate/heure auxquelles le compte a été actif pour la dernière fois (horodatage ISO 8601)
raw_loginInformations de connexion brutes (au format JSON)
2fa_enabled?Indique si l’utilisateur a activé l’authentification à 2 facteurs

Rapports d’organisation

CléDescription
idID d’organisation
created_atDate/heure de création de l’organisation
loginNom de connexion de l’organisation
emailAdresse e-mail principale de l’organisation
ownersNombre de propriétaires de l’organisation
membersNombre de membres de l’organisation
teamsNombre d’équipes de l’organisation
reposNombre de dépôts de l’organisation
2fa_required?Indique si l’organisation exige une authentification à 2 facteurs

Rapports de dépôt

CléDescription
created_atDate/heure de création du dépôt
owner_idID du propriétaire du dépôt
owner_typeIndique si le dépôt est la propriété d’un utilisateur ou d’une organisation
owner_nameNom du propriétaire du dépôt
idID du dépôt
nameNom du dépôt
visibilityIndique si le dépôt est public ou privé
readable_sizeTaille du dépôt dans un format compréhensible
raw_sizeTaille du dépôt sous forme de nombre
collaboratorsNombre de collaborateurs dans le dépôt
fork?Indique si le dépôt est une duplication (fork)
deleted?Indique si le dépôt a été supprimé