Aanmelden met Microsoft: Huisstijlrichtlijnen voor toepassingen

Wanneer u toepassingen ontwikkelt met het Microsoft Identity Platform, moet u uw klanten omleiden wanneer ze hun werk- of schoolaccount willen gebruiken (beheerd in Microsoft Entra-id) of hun persoonlijke account voor registratie en aanmelding bij uw toepassing.

In dit artikel leert u het volgende:

  • Meer informatie over de twee soorten gebruikersaccounts die worden beheerd door Microsoft en hoe u verwijst naar Microsoft Entra-accounts in uw toepassing
  • Meer informatie over de vereisten voor het gebruik van het Microsoft-logo in uw app
  • Hoe u de officiële afbeeldingen voor Aanmelden of Aanmelden bij Microsoft downloadt voor gebruik in uw app
  • De do's en don'ts van huisstijl en navigatie

Persoonlijke accounts vs. werk- of schoolaccounts van Microsoft

Microsoft beheert twee soorten gebruikersaccounts:

  • Persoonlijke accounts (voorheen bekend als Windows Live ID). Deze accounts vertegenwoordigen de relatie tussen afzonderlijke gebruikers en Microsoft, en worden gebruikt om toegang te verkrijgen tot consumentenapparaten en services van Microsoft. Deze accounts zijn bedoeld voor persoonlijk gebruik.
  • Werk- of schoolaccounts. Deze accounts worden beheerd door Microsoft namens organisaties die gebruikmaken van Microsoft Entra-id. Deze accounts worden gebruikt voor aanmelding bij Microsoft 365 en andere zakelijke services van Microsoft.

Werk- of schoolaccounts van Microsoft worden meestal toegewezen aan eindgebruikers (werknemers, leerlingen/studenten, overheidspersoneel) door hun organisaties (bedrijf, school, overheidsinstelling). Deze accounts worden rechtstreeks in de cloud (in Microsoft Entra-id) of gesynchroniseerd met Microsoft Entra-id vanuit een on-premises directory, zoals Windows Server Active Directory. Microsoft is de bewaarder van de werk- of schoolaccounts, maar de accounts zijn eigendom van en worden beheerd door de organisatie.

Verwijzen naar Microsoft Entra-accounts in uw toepassing

Microsoft stelt eindgebruikers niet bloot aan de merknaam Azure of Active Directory, en u moet dat ook niet doen.

  • Zodra gebruikers zijn aangemeld, moeten ze de naam en het logo van de organisatie zoveel mogelijk zien. Dit is beter dan algemene termen zoals ‘uw organisatie’ te gebruiken.
  • Wanneer gebruikers niet zijn aangemeld, moet u naar hun accounts verwijzen als ‘werk- of schoolaccounts’ en het Microsoft-logo gebruiken om te laten zien dat Microsoft deze accounts beheert. Gebruik geen termen zoals ‘ondernemingsaccount’, ‘bedrijfsaccount’ of ‘zakelijk account’, want die kunnen voor verwarring zorgen bij de gebruiker.

Pictogram van het gebruikersaccount

In een eerdere versie van deze richtlijnen raadden we aan een pictogram van een ‘blauwe badge’ te gebruiken. Naar aanleiding van feedback van gebruikers en ontwikkelaars raden we nu echter aan het Microsoft-logo te gebruiken. Met het Microsoft-logo kunnen gebruikers begrijpen dat ze het account dat ze gebruiken met Microsoft 365 of andere Zakelijke Services van Microsoft opnieuw kunnen gebruiken om zich aan te melden bij uw app.

Registreren en aanmelden met Microsoft Entra-id

Uw app heeft misschien aparte paden voor registratie en aanmelding, en de volgende secties bieden visuele begeleiding voor beide scenario’s.

Als uw app eindgebruikersregistratie ondersteunt (bijvoorbeeld voor een gratis proefversie of freemium-model): U kunt een knop Aanmelden tonen waarmee gebruikers toegang tot uw app kunnen verkrijgen met hun werkaccount of persoonlijke account. Microsoft Entra-id toont een toestemmingsprompt wanneer ze uw app voor het eerst openen.

Als uw app toestemmingen nodig heeft die alleen beheerders kunnen verlenen, of als uw app organisatielicenties nodig heeft: Scheid beheerdersdownload van gebruikersaanmelding. Met de knop Download deze app worden beheerders naar de aanmeldingspagina geleid, waarna ze worden gevraagd toestemming te verlenen namens gebruikers in hun organisatie. Dit heeft het extra voordeel dat instemmingsprompts voor eindgebruikers naar uw app worden onderdrukt.

Visuele begeleiding voor app-download

De koppeling 'De app ophalen' moet de gebruiker omleiden naar de microsoft Entra ID-pagina voor het verlenen van toegang (autoriseren) om de beheerder van een organisatie toestemming te geven voor uw app om toegang te krijgen tot de gegevens van de organisatie, die wordt gehost door Microsoft. Details over het aanvragen van toegang worden besproken in het artikel Integratietoepassingen met Microsoft Entra ID .

Nadat beheerders toestemming hebben verleend voor uw app, kunnen ze ervoor kiezen deze toe te voegen aan het startprogramma voor Microsoft 365-apps van hun gebruikers (toegankelijk via het wafelmenu en via https://www.office.com/). Als u deze mogelijkheid wilt adverteren, kunt u termen zoals ‘Voeg deze app aan uw organisatie toe’ gebruiken en een knop tonen zoals in het volgende voorbeeld:

Button showing the Microsoft logo and

We raden u echter aan verklarende tekst te schrijven in plaats van op knoppen te vertrouwen. Voorbeeld:

Als u Microsoft 365 of andere zakelijke services van Microsoft al gebruikt, kunt u <naam_van_uw_app> toegang verlenen tot de gegevens van uw organisatie. Zo kunnen uw gebruikers toegang tot <naam_van_uw_app> verkrijgen met hun bestaande werkaccount.

Als u het officiële Microsoft-logo wilt downloaden voor gebruik in uw app, klikt u met de rechtermuisknop op het logo dat u wilt gebruiken en slaat u het op naar uw computer.

Activa PNG-indeling SVG-indeling
Microsoft-logo Downloadable Microsoft logo in PNG format Downloadable Microsoft logo in SVG format

Visuele begeleiding voor aanmelding

Uw app moet een aanmeldingsknop weergeven waarmee gebruikers worden omgeleid naar het aanmeldingseindpunt dat overeenkomt met het protocol dat u gebruikt om te integreren met Microsoft Entra-id. De volgende sectie biedt meer informatie over hoe de knop eruit moet zien.

Pictogram en ‘Aanmelden met Microsoft’

Het is de koppeling van het Microsoft-logo en de termen 'Aanmelden met Microsoft' die microsoft-id uniek vertegenwoordigen onder andere id-providers die uw app mogelijk ondersteunt. Als u niet genoeg ruimte hebt voor ‘Aanmelden met Microsoft’, kunt u dit afkorten tot ‘Aanmelden’. Voor de knoppen kunt u een licht of donker kleurenschema gebruiken.

Het volgende diagram toont de door Microsoft aanbevolen rode lijnen wanneer u de assets met uw app gebruikt. De rode lijnen zijn van toepassing op ‘Aanmelden met Microsoft’ en de kortere versie ‘Aanmelden’.

Shows the

Als u de officiële afbeelding wilt downloaden voor gebruik in uw app, klikt u met de rechtermuisknop op de afbeelding die u wilt gebruiken en slaat u deze op naar uw computer.

Activa PNG-indeling SVG-indeling
Aanmelden met Microsoft (donker thema) Downloadable Downloadable
Aanmelden met Microsoft (licht thema) Downloadable Downloadable
Aanmelden (donker thema) Downloadable Downloadable
Aanmelden (licht thema) Downloadable Downloadable

Gelokaliseerde terminologie en UI-tekenreeksen

Microsoft-terminologie kan worden gebruikt om ervoor te zorgen dat terminologie in uw gelokaliseerde versies van toepassingen overeenkomt met de bijbehorende terminologie in Microsoft-producten. U kunt een query uitvoeren op de Microsoft-terminologie via de microsoft-pagina Terminologie zoeken.

Vertalingen van Microsoft UI-tekenreeksen kunnen worden gebruikt om ervoor te zorgen dat vertalingen in de gelokaliseerde versies van uw toepassingen overeenkomen met de bijbehorende UI-tekenreeksen in Microsoft-producten. U kunt query's uitvoeren op de Microsoft UI-tekenreeksen via de microsoft UI String Search-pagina.

Huisstijl: wel en niet doen

WEL DOEN ‘Werk- of schoolaccount’ gebruiken in combinatie met de knop ‘Aanmelden met Microsoft’ om eindgebruikers te helpen zien of ze het kunnen gebruiken. NIET DOEN Andere termen zoals ‘ondernemingsaccount’, ‘bedrijfsaccount’ of ‘zakelijk account’ gebruiken.

NIET DOEN "Microsoft 365-ID" of "Azure-ID" gebruiken. Microsoft 365 is ook de naam van een consumentenaanbod van Microsoft, dat geen Microsoft Entra-id gebruikt voor verificatie.

NIET DOEN Het Microsoft-logo wijzigen.

NIET DOEN Eindgebruikers blootstellen aan het merk Azure of Active Directory. U kunt deze termen echter wel gebruiken bij ontwikkelaars, IT-professionals en beheerders.

WEL DOEN Gebruikers een manier bieden om zich af te melden en naar een ander gebruikersaccount te schakelen. Hoewel de meeste mensen één persoonlijk account van Microsoft/Facebook/Google/Twitter hebben, zijn mensen vaak gekoppeld aan meer dan één organisatie. Ondersteuning voor meerdere aangemelde gebruikers zal binnenkort beschikbaar zijn.