Udostępnij za pośrednictwem

Samouczek: wywoływanie interfejsu API programu Microsoft Graph z poziomu aplikacji internetowej Node/Express.js

  • Artykuł

Dotyczy: Zielony okrąg z białym symbolem zaznaczenia. Najemcy Workforce Zielony okrąg z białym symbolem zaznaczenia. Najemcy zewnętrzni (więcej informacji)

W tym samouczku wywołasz interfejs API programu Microsoft Graph z poziomu aplikacji internetowej Node/Express.js. Po zalogowaniu się użytkownik uzyskuje token dostępu w celu wywołania interfejsu API programu Microsoft Graph.

Ten samouczek jest częścią 3 z 3-częściowej serii samouczków.

W tym samouczku Ty:

  • Aktualizowanie aplikacji internetowej Node/Express.js w celu uzyskania tokenu dostępu
  • Użyj tokenu dostępu, aby wywołać interfejs API programu Microsoft Graph.

Warunki wstępne

Dodawanie składników interfejsu użytkownika

  1. W edytorze kodu otwórz plik views/index.hbs, a następnie dodaj link Wyświetl profil użytkownika przy użyciu następującego fragmentu kodu:

    <a href="/users/profile">View user profile</a>

    Po wprowadzeniu aktualizacji plik views/index.hbs powinien wyglądać podobnie do następującego pliku:

       <h1>{{title}}</h1>
    {{#if isAuthenticated }}
    <p>Hi {{username}}!</p>
    <a href="/users/id">View ID token claims</a>
    <br>
    <a href="/users/profile">View user profile</a>
    <br>
    <br>
    <a href="/auth/signout">Sign out</a>
    {{else}}
    <p>Welcome to {{title}}</p>
    <a href="/auth/signin">Sign in</a>
    {{/if}}

  2. Utwórz plik views/profile.hbs, a następnie dodaj następujący kod:

    <h1>Microsoft Graph API</h1>
<h3>/me endpoint response</h3>
<table>
    <tbody>
        {{#each profile}}
        <tr>
            <td>{{@key}}</td>
            <td>{{this}}</td>
        </tr>
        {{/each}}
    </tbody>
</table>
<br>
<a href="/">Go back</a>
    • Na tej stronie zostaną wyświetlone szczegóły profilu użytkownika zwracane przez interfejs API programu Microsoft Graph.

Uzyskiwanie tokenu dostępu

W edytorze kodu otwórz plik auth/AuthProvider.js, a następnie dodaj metodę getToken w klasie AuthProvider:

class AuthProvider {
    //...
        getToken(scopes, redirectUri = "http://localhost:3000/") {
            return  async function (req, res, next) {
                const msalInstance = authProvider.getMsalInstance(authProvider.config.msalConfig);
                try {
                    msalInstance.getTokenCache().deserialize(req.session.tokenCache);
    
                    const silentRequest = {
                        account: req.session.account,
                        scopes: scopes,
                    };
                    const tokenResponse = await msalInstance.acquireTokenSilent(silentRequest);
    
                    req.session.tokenCache = msalInstance.getTokenCache().serialize();
                    req.session.accessToken = tokenResponse.accessToken;
                    next();
                } catch (error) {
                    if (error instanceof msal.InteractionRequiredAuthError) {
                        req.session.csrfToken = authProvider.cryptoProvider.createNewGuid();
    
                        const state = authProvider.cryptoProvider.base64Encode(
                            JSON.stringify({
                                redirectTo: redirectUri,
                                csrfToken: req.session.csrfToken,
                            })
                        );
                        
                        const authCodeUrlRequestParams = {
                            state: state,
                            scopes: scopes,
                        };
    
                        const authCodeRequestParams = {
                            state: state,
                            scopes: scopes,
                        };
    
                        authProvider.redirectToAuthCodeUrl(
                            req,
                            res,
                            next,
                            authCodeUrlRequestParams,
                            authCodeRequestParams,
                            msalInstance
                        );
                    }
    
                    next(error);
                }
            };
        }
}
    //...

Metoda getToken używa określonego zakresu do uzyskania tokenu dostępu

Dodawanie trasy interfejsu API wywołań

W edytorze kodu otwórz plik routes/users.js, a następnie dodaj następującą trasę:

router.get(
    "/profile",
    isAuthenticated,
    authProvider.getToken(["User.Read"]), // check if user is authenticated
    async function (req, res, next) {
    const graphResponse = await fetch(
        GRAPH_ME_ENDPOINT,
        req.session.accessToken,
    );
    if (!graphResponse.id) {
        return res 
        .status(501) 
        .send("Failed to fetch profile details"); 
    }
    res.render("profile", {
        profile: graphResponse,
    });
    },
);

  • Wyzwalasz trasę /profile, gdy klient wybierze link Wyświetl profil użytkownika. Aplikacja:

    • Uzyskuje token dostępu z uprawnieniem User.Read.
    • Wykonuje wywołanie interfejsu API programu Microsoft Graph w celu odczytania profilu zalogowanego użytkownika.
    • Wyświetla szczegóły użytkownika w interfejsie profile.hbs UI.

Wywoływanie interfejsu API programu Microsoft Graph

Utwórz plik fetch.js, a następnie dodaj następujący kod:

var axios = require('axios');
var authProvider = require("./auth/AuthProvider");

/**
 * Makes an Authorization "Bearer" request with the given accessToken to the given endpoint.
 * @param endpoint
 * @param accessToken
 * @param method
 */
const fetch = async (endpoint, accessToken, method = "GET", data = null) => {
    const options = {
        headers: {
            Authorization: `Bearer ${accessToken}`,
        },
    };

    console.log(`request made to ${endpoint} at: ` + new Date().toString());

    try{
        const response = await axios.get(endpoint, options);
        return await response.data;

    }catch(error){
        throw new Error(error);
    }

};

module.exports = { fetch };

Rzeczywiste wywołanie interfejsu API odbywa się w pliku fetch.js.

Uruchamianie i testowanie aplikacji internetowej Node/Express.js

  1. Wykonaj kroki opisane w Uruchom i przetestuj aplikację internetową Node/Express.js, aby uruchomić aplikację internetową.
  2. Po zalogowaniu się wybierz link Wyświetl profil użytkownika. Jeśli aplikacja działa poprawnie, powinieneś zobaczyć profil zalogowanego użytkownika, odczytany z interfejsu API Microsoft Graph.

Powiązana zawartość