C++ Requires Chilkat v11.5.0+

Box: Authorize a User with OAuth 2.0

See more Box Examples

Interactive local-development example using a browser and a loopback callback. Register exactly http://localhost:3017/ in the Box User app. Run this in a trusted environment that can hold the client secret. A deployed web app must handle its registered HTTPS callback on the server.

See the Box API guide for setup and the complete workflow.

C++

#include <CkOAuth2.h>
#include <CkJsonObject.h>

void ChilkatSample(void)
    {
    bool success = false;

    //  Requires Chilkat 11.5.0 or later and a previously unlocked Chilkat bundle.
    //  See Global Unlock Sample.
    //  Guide: Box API Guide.

    success = false;

    CkOAuth2 oauth2;
    oauth2.put_ListenPort(3017);
    oauth2.put_AuthorizationEndpoint("https://account.box.com/api/oauth2/authorize");
    oauth2.put_TokenEndpoint("https://api.box.com/oauth2/token");
    oauth2.put_ClientId("BOX_CLIENT_ID");
    oauth2.put_ClientSecret("BOX_CLIENT_SECRET");
    //  Use Box's documented confidential-client authorization-code flow.
    oauth2.put_CodeChallenge(false);
    const char *url = oauth2.startAuth();
    if (oauth2.get_LastMethodSuccess() != true) {
        std::cout << oauth2.lastErrorText() << "\r\n";
        return;
    }

    success = oauth2.LaunchBrowser(url);
    if (success != true) {
        std::cout << oauth2.lastErrorText() << "\r\n";
        return;
    }

    int elapsedMs = 0;
    while ((elapsedMs < 120000) && (oauth2.get_AuthFlowState() < 3)) {
        oauth2.SleepMs(100);
        elapsedMs = elapsedMs + 100;
    }

    if (oauth2.get_AuthFlowState() < 3) {
        oauth2.Cancel();
        std::cout << "Authorization timed out." << "\r\n";
        return;
    }

    if (oauth2.get_AuthFlowState() != 3) {
        std::cout << "Authorization was denied or failed. State: " << oauth2.get_AuthFlowState() << "\r\n";
        return;
    }

    //  Retain both tokens in your application's protected token store.
    //  The variables below are deliberately not printed.
    const char *accessToken = oauth2.accessToken();
    const char *refreshToken = oauth2.refreshToken();
    //  For this local-development example only, save in a directory restricted to this user.
    //  Create qa_data/tokens before running; never put this file under a web root.
    CkJsonObject tokens;
    success = tokens.Load(oauth2.accessTokenResponse());
    if (success != true) {
        std::cout << tokens.lastErrorText() << "\r\n";
        return;
    }

    success = tokens.WriteFile("qa_data/tokens/box_oauth.json");
    if (success != true) {
        std::cout << tokens.lastErrorText() << "\r\n";
        return;
    }

    std::cout << "Authorization complete; token response saved in the protected local token file." << "\r\n";
    }