My Apps

    TLS 1.1 Deprecation Migration

    TLS 1.1 Deprecation Migration

    Overview

    To keep your API communications with Box secure, Box will no longer provide support for products and services that rely on the Transport Layer Security (TLS) 1.1 encryption protocol as of March 1, 2019.

    General Testing Instructions

    To confirm your application will work when we remove support for TLS 1.1, we created a new base URL https://api-test.box.com/2.0/ that you can test with any Box API endpoint to confirm your application supports TLS 1.2 or higher. This test endpoint will refuse any requests made with TLS 1.1.

    If you make an API call to the test endpoint and get a connection refused error, then your environment needs to be upgraded to support TLS 1.2 or higher. If you make an API call to the test endpoint and you receive a successful response, then your environment supports TLS 1.2 or higher and no action is needed.

    The only endpoint that will not work for testing with this test endpoint is the upload endpoint.

    Testing & Upgrade Instructions by Language

    .NET

    Test (.Net)

    Using the .NET SDK 3.8.0 or higher.

    BoxConfig config = new BoxConfig(/* config parameters */);
    config.BoxApiUri = new System.Uri("https://api-test.box.com/2.0/");

    Upgrade (.Net)

    • Upgrade to version 4.6 of the .NET framework. Alternatively, upgrade to 4.5 of the .NET framework, and include the line below in your application.
    //Make sure this line is globally scoped in your application.
    ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12
    • If you are using the Box .NET or .NET Core SDK, upgrade to version 3.5.2 or above.

    Java

    Test (Java)

    BoxAPIConnection api = new BoxAPIConnection(/* connection parameters */);
    api.setBaseURL("https://api-test.box.com/2.0/");

    Upgrade (Java)

    • Upgrade to version 1.8 or higher of the Java Runtime Environment.
    • Upgrade to Box Java SDK version 2.14.1 or higher.

    Node

    If you are using the official build of Node, you will not be affected.

    Test (Node)

    var BoxSDK = require('box-node-sdk');
    var sdk = new BoxSDK({
      /* Other configuration parameters */
      apiRootURL: 'https://api-test.box.com'
    });

    Ruby

    Upgrade (Ruby)

    Upgrade to Ruby 2.0.0 or later and OpenSSL 1.0.1 or later.

    Python

    Upgrade (Python)

    • If you are using Python 2.7.9 and higher, it is compatible with TLS 1.2 or higher by default.
    • If you are using Python 2.7.8 and below, you will need to update to Python version 2.7.9 or higher.

    Android

    Upgrade (Android)

    Upgrade to version 5.0 of the Android framework or higher (API level 20 or higher).