GitHub

GitHubè una piattaforma e un servizio basato su cloud per lo sviluppo di software e il controllo delle versioni tramite Git, che consente agli sviluppatori di archiviare e gestire il proprio codice. Fornisce il controllo della versione distribuita di Git più il controllo degli accessi, il tracciamento dei bug, le richieste di funzionalità software, la gestione delle attività, l'integrazione continua e i wiki per ogni progetto. AWS AppFabric Per motivi di sicurezza puoi ricevere log di controllo e dati utente daGitHub, normalizzare i dati in formato Open Cybersecurity Schema Framework (OCSF) e inviarli in un bucket Amazon Simple Storage Service (Amazon S3) o in un flusso Amazon Data Firehose.

AppFabric supporto per GitHub

AppFabric supporta la ricezione di informazioni sugli utenti e registri di controllo daGitHub.

Prerequisiti

AppFabric Per utilizzare il trasferimento dei log di controllo GitHub da destinazioni supportate, è necessario soddisfare i seguenti requisiti:

• Per accedere ai registri di controllo è necessario disporre di un account aziendale.

• Per accedere ai log di controllo aziendali è necessario avere il ruolo di amministratore per il proprio account aziendale.

• Per ottenere i log di controllo dall'organizzazione, devi essere il proprietario dell'organizzazione.

Considerazioni sui limiti di velocità

GitHubimpone limiti di velocità all'GitHubAPI. Per ulteriori informazioni sui limiti di velocità delle GitHub API, consulta la sezione API Request Limits and Allocations sul GitHub sito Web. Se la combinazione delle applicazioni GitHub API esistenti AppFabric e quelle esistenti superano i GitHub’s limiti, la visualizzazione dei log di controllo AppFabric potrebbe subire ritardi.

Considerazioni sul ritardo dei dati

Potresti riscontrare un ritardo fino a 30 minuti prima che un evento di audit venga consegnato a destinazione. Ciò è dovuto al ritardo negli eventi di controllo resi disponibili dall'applicazione e alle precauzioni adottate per ridurre la perdita di dati. Tuttavia, questo potrebbe essere personalizzabile a livello di account. Per assistenza, contatta. AWS Support

Connessione AppFabric al tuo GitHub account

Dopo aver creato il pacchetto di app all'interno del AppFabric servizio, devi autorizzare AppFabric con. GitHub Per trovare le informazioni necessarie per l'autorizzazione GitHub con AppFabric, utilizza la procedura seguente.

Crea un'applicazione OAuth

AppFabric si integra con l'utilizzo di OAuthGitHub. Usa i seguenti passaggi per creare un'applicazione OAuth in. GitHub Per ulteriori informazioni, consulta Creazione di GitHubs app sul GitHub sito Web.

1. Scegli la tua foto del profilo situata nell'angolo in alto a destra della pagina, quindi scegli Impostazioni.

2. Scegli Impostazioni sviluppatore nel riquadro di navigazione a sinistra.

3. Scegli le app OAuth nel riquadro di navigazione a sinistra.

4. Scegli Nuova app OAuth.

   Nota

   Questo pulsante sarà denominato Registra una nuova applicazione se non hai precedentemente creato un'app OAuth.

5. Inserisci il nome dell'app nella casella di testo Nome applicazione.

6. Immettete l'URL completo dell'istanza dell'applicazione nella casella di testo URL della home page.

7. (Facoltativo) Inserisci una descrizione per l'app nella casella di testo Descrizione dell'applicazione. Gli utenti vedranno questa descrizione.

8. Inserisci un URL con il seguente formato nella casella di testo URL di richiamata di autorizzazione.

   https://<region>.console.aws.amazon.com/appfabric/oauth2

   In questo URL, <region>è riportato il codice Regione AWS in cui hai configurato il pacchetto di AppFabric app. Ad esempio, il codice per la regione Stati Uniti orientali (Virginia settentrionale) è. us-east-1 Per quella regione, l'URL di reindirizzamento è. https://us-east-1.console.aws.amazon.com/appfabric/oauth2

9. Scegli Abilita Device Flow se l'app OAuth utilizzerà Device Flow per identificare e autorizzare gli utenti. Per ulteriori informazioni sul flusso dei dispositivi, consulta Autorizzazione delle app OAuth sul sito Web. GitHub

10. Scegli Registra applicazione.

Autorizzazioni delle app

ID tenant

AppFabric richiederà il tuo ID inquilino. L'ID del tenant deve essere fornito in uno dei seguenti formati:

Registro di controllo aziendale:

Utilizza il registro di controllo aziendale se desideri conoscere le azioni aggregate di tutte le organizzazioni di proprietà del tuo account aziendale.

Per utilizzare il registro di controllo aziendale, l'ID tenant è l'ID aziendale del tuo account. Puoi trovare il tuo ID aziendale nella barra degli indirizzi del browser. Ad esempio, exampleenterprise è l'ID aziendale nel seguente URLhttps://github.com/settings/enterprises/examplenterprise.

Quando si specifica l'ID tenant per il registro di controllo aziendale, è necessario prefissarlo con. enterprise: Pertanto, specificate l'esempio precedente come. enterprise:examplenterprise

Registro di controllo dell'organizzazione:

Utilizza il registro di controllo dell'organizzazione come amministratore dell'organizzazione se desideri conoscere le azioni eseguite dai membri della tua organizzazione. Include dettagli come chi ha eseguito l'azione, qual è stata l'azione e quando è stata eseguita.

Per utilizzare il registro di controllo dell'organizzazione, l'ID tenant è l'ID dell'organizzazione. Puoi trovare l'ID della tua organizzazione nella barra degli indirizzi del browser. Ad esempio, exampleorganization è l'ID dell'organizzazione nel seguente URLhttps://github.com/settings/organizations/exampleorganization.

Quando si specifica l'ID tenant per il registro di controllo dell'organizzazione, è necessario prefissarlo con. organization: Pertanto, specificate l'esempio precedente come. organization:exampleorganization

Nome dell'inquilino

Immettere un nome che identifichi l'GitHubazienda o l'organizzazione univoca. AppFabric utilizza il nome del tenant per etichettare le autorizzazioni dell'app e le eventuali acquisizioni create dall'autorizzazione dell'app.

ID client

AppFabric richiederà un ID cliente. Usa i seguenti passaggi per trovare il tuo ID cliente inGitHub,

1. Scegli la tua foto del profilo situata nell'angolo in alto a destra della pagina, quindi scegli Impostazioni.

2. Scegli Impostazioni sviluppatore nel riquadro di navigazione a sinistra.

3. Scegli le app OAuth nel riquadro di navigazione a sinistra.

4. Scegli l'app OAuth specifica, quindi cerca il valore dell'ID client.

Client secret

AppFabric richiederà un segreto per il cliente. Segui i seguenti passaggi per trovare il segreto del tuo cliente inGitHub.

1. Scegli la tua foto del profilo situata nell'angolo in alto a destra della pagina, quindi scegli Impostazioni.

2. Scegli Impostazioni sviluppatore nel riquadro di navigazione a sinistra.

3. Scegli le app OAuth nel riquadro di navigazione a sinistra.

4. Scegli l'app OAuth specifica, quindi cerca il valore Client Secret. Se non riesci a trovare un client secret esistente, potrebbe essere necessario generarne uno nuovo.

Approva l'autorizzazione

Dopo aver creato l'autorizzazione dell'app in AppFabric, riceverai una finestra pop-up da GitHub cui approvare l'autorizzazione. Per approvare l' AppFabric autorizzazione, scegli Consenti.

Assicurati che le tue organizzazioni abbiano concesso l'accesso all'app OAuth, se le restrizioni di accesso all'app OAuth sono abilitate.