Een GitHub- en Livefyre-account instellen

Uw GitHub-account instellen

Als u wilt bijdragen aan technische inhoud van Docs, moet u een eigen GitHub-account maken. Het goede nieuws is dat u de meeste stappen maar één keer hoeft uit te voeren.

1. Ee GitHub-account maken en uw profiel instellen

Als u nog geen account hebt, moet u een GitHub-account maken.

Notitie

Als u een werknemer van Microsoft bent, moet u zichzelf duidelijk als zodanig identificeren. Stel als volgt uw GitHub-profiel in:

  • Profielafbeelding: een afbeelding van uzelf (vereist).
  • Naam: uw voor- en achternaam (vereist).
  • E-mailadres: uw Microsoft-e-mailadres (optioneel).
  • Bedrijf: Microsoft Corporation (vereist).
  • Locatie: vermeld uw locatie (optioneel).

Uw profiel moet er ongeveer als volgt uitzien wanneer u klaar bent:

Voorbeeld van een GitHub-profiel

Raadpleeg Abonneren op SkyEye-meldingen als u zich wilt opgeven voor Livefyre-feedmeldingen.

2. Aanvullende stappen voor Microsoft-medewerkers

Personen met een GitHub-account kunnen bijdragen aan Docs-inhoud leveren door gebruik te maken van een van onze openbare opslagplaatsen. Er zijn geen aanvullende machtigingen vereist voor openbare inhoudsopslagplaatsen en er hoeft dus geen koppeling te worden gemaakt.

We geven er echter de voorkeur aan dat Microsoft-medewerkers hun bijdrage leveren aan privéopslagplaatsen wanneer deze beschikbaar zijn. Doe hiervoor het volgende:

  1. Ga naar de open source-koppelingspagina van Microsoft om u aan te melden en voer de stappen uit om uw GitHub-account aan uw Microsoft-account te koppelen. Als uw accounts al zijn gekoppeld, ziet u een groene afbeelding met de tekst Koppeling in orde. U kunt dan doorgaan met het gedeelte over het inschakelen van tweeledige verificatie.

  2. Word op de pagina met open source-organisaties van Microsoft lid van de betreffende GitHub-organisatie waar u gaat samenwerken met anderen, zoals de Microsoft- en MicrosoftDocs-organisatie. Dit wordt bepaald op basis van de organisatie waar de opslagplaats zich bevindt: https://github.com/<organization>/<repo>. In het gedeelte Uw Microsoft GitHub-organisaties worden aan de linkerkant de GitHub-organisaties weergegeven waartoe u al behoort. Aan de rechterkant worden meer beschikbare organisaties weergegeven. Selecteer een beschikbare organisatie om er lid van te worden.

  3. Nadat u lid bent geworden van een organisatie, wordt u toegevoegd aan het team 'Iedereen' van de organisatie, die door veel privéopslagplaatsen wordt gebruikt als het team met leesmachtigingen. Dit is mogelijk de enige vereiste stap. Maar als uw team vereist dat u van een specifiek team lid wordt, doet u het volgende:

    a. Selecteer onder het bovenste menu de koppeling Team en selecteer vervolgens de knop Beschikbare teams.

    b. Voer in het zoekveld de naam van het team in die u van de GitHub-beheerder hebt gekregen en selecteer vervolgens Zoeken.

    c. Selecteer de teamnaam in de lijst met resultaten en selecteer vervolgens Lid worden.

2.b. Tweeledige verificatie inschakelen en een toegangstoken maken (Microsoft-medewerkers)

Microsoft-medewerkers moeten tweeledige verificatie (2FA) inschakelen in hun GitHub-account om in de opslagplaatsen met privé-inhoud te kunnen werken.

  1. Raadpleeg de instructies in het GitHub-artikel Uw account beveiligen met tweeledige verificatie (2FA) als u tweeledige verificatie wilt inschakelen. Zoals beschreven in het artikel, kunt u het beste de volgende stappen uitvoeren:

    a. Lees Tweeledige verificatie configureren via een mobiele TOTP-app waarin staat beschreven hoe u de betreffende mobiele TOTP-app voor uw mobiele apparaat downloadt.

    b. Download de herstelcodes voor de tweeledige verificatie en sla deze op als u dat nog niet hebt gedaan.

    c. Stel een SMS-nummer als vervanging in voor de verificatie voor het geval dat u geen toegang meer hebt tot uw primaire apparaat en de herstelcodes.

    De eerste keer dat u zich bij GitHub verifieert vanuit Git, wordt u gevraagd om uw verificatiecode voor tweeledige verificatie op te geven met de mobiele TOTP-app die u in deze procedure hebt geconfigureerd.

  2. Nadat u tweeledige verificatie hebt ingeschakeld, raadpleegt u Een toegangstoken maken voor gebruik in opdrachtregels om een beveiligingstoken te maken die voor verificatie wordt gebruikt wanneer u toegang wilt krijgen tot GitHub door middel van opdrachtregelfuncties. Wanneer u de token maakt, selecteert u alle bereiken die beschikbaar zijn in de gebruikersinterface voor het maken van tokens. (U kunt details voor elk bereik krijgen.)

    Uw toegangstoken wordt gebruikt in plaats van uw GitHub-wachtwoord wanneer u vanaf de opdrachtregel toegang wilt krijgen tot een GitHub-opslagplaats.

    Belangrijk

    De toegangstoken is niet de verificatiecode die u in een tekstbericht ontvangt wanneer u tweeledige verificatie instelt. Het is een lange tekenreeks die er ongeveer als volgt uitziet: fdd3b7d3d4f0d2bb2cd3d58dba54bd6bafcd8dee.

Nadat u de toegangstoken hebt gemaakt, slaat u deze op een veilige locatie op zodat de token gelijk beschikbaar is wanneer u deze nodig hebt.

2.c. Het OPS-compositiesysteem toegang verlenen tot uw GitHub-account (Microsoft-medewerkers)

Als u een Microsoft-medewerker bent, moet u het OPS-compositiesysteem autorisatie verlenen (ook wel 'toestemming geven' genoemd) zodat deze toegang krijgt tot gegevens in uw GitHub-accountprofiel. Dit is vereist zodat het compositiesysteem toegang krijgt tot profielgegevens, zoals uw Microsoft-e-mailadres, en de opslagplaatsen waar u tijdens de compositie pull-aanvragen zult indienen.

  1. Ga naar de OPS-portal.
  2. Voer de verificatie uit met uw GitHub-referenties.
  3. Controleer of de organisatienaam van uw OPS-opslagplaatsen (bijvoorbeeld MicrosoftDocs) wordt vermeld onder Toegang tot organisatie.
  4. Selecteer de knop openpublish machtigen.

    Toepassing voor het machtigen van OPS

Wanneer autorisatie is verleend, wordt u doorgestuurd naar de startpagina van de OPS-portal. U kunt deze sluiten.

Uw Livefyre-account instellen

Elk gepubliceerd Docs-artikel biedt ondersteuning voor een opmerkingenstream die wordt geleverd door de Livefyre-service. Livefyre biedt lezers niet alleen de mogelijkheid om onder aan een pagina opmerkingen te plaatsen, maar over de gehele pagina, op het niveau van de zin of alinea. Deze functie is alleen beschikbaar voor Engelse artikelen.

Als auteur of inzender van een artikel moet u zich opgeven voor Livefyre zodat u kunt deelnemen aan de opmerkingenstream voor het artikel.

  1. Gebruik een docs.microsoft.com-pagina om uw Livefyre-account te maken. U kunt bijvoorbeeld de volgende pagina gebruiken: https://docs.microsoft.com/nl-nl/azure/active-directory/develop/active-directory-developers-guide.

  2. Selecteer onderaan het artikel de koppeling Aanmelden boven in het gedeelte met opmerkingen.

  3. Kies een identiteitsprovider voor een bestaand account dat u voor aanmelden wilt gebruiken (linkerkant). U kunt ook Nieuw account maken selecteren om een nieuw account op basis van een e-mailadres te maken (rechterkant).

    Als u een Microsoft-medewerker bent, moet u het laatste doen. In het dialoogvenster voor verificatie voert u de profielgegevens als volgt in en klikt u op Registreren:

    • Gebruikersnaam: uw Microsoft-e-mailalias gevolgd door @MSFT, zoals: alias@MSFT
    • E-mailadres: uw microsoft.com-e-mailadres.

Volgende stappen

  • Ga verder naar het artikel Toolinstallaties om Git Bash, een Markdown-editor, en meer te installeren.