Office365-REST-Python-Client 2.5.3__tar.gz → 2.5.4__tar.gz

{Office365-REST-Python-Client-2.5.3 → Office365-REST-Python-Client-2.5.4/Office365_REST_Python_Client.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: Office365-REST-Python-Client
-Version: 2.5.3
+Version: 2.5.4
 Summary: Microsoft 365 & Microsoft Graph Library for Python
 Home-page: https://github.com/vgrem/Office365-REST-Python-Client
 Author: Vadim Gremyachev
@@ -58,7 +58,6 @@ pip install Office365-REST-Python-Client
 
 ### Note 
 >
-
 >Alternatively the _latest_ version could be directly installed via GitHub:
 >```
 >pip install git+https://github.com/vgrem/Office365-REST-Python-Client.git
@@ -206,6 +205,20 @@ The list of examples:
   
 Refer [examples section](examples/sharepoint) for another scenarios
 
+### Support for non-standard SharePoint Online Environments
+
+  Support for non-standard SharePoint Environments is currently being implemented. Currently supported:
+  - GCC High
+
+  To enable authentication to GCC High endpoints, add the `environment='GCCH'` parameter when calling the 
+  `ClientContext class` with `.with_user_credentials`, `.with_client_credentials`, or `.with_credentials`
+
+   Example:
+   ```python
+   client_credentials = ClientCredential('{client_id}','{client_secret}')
+   ctx = ClientContext('{url}').with_credentials(client_credentials, environment='GCCH')
+   ```
+
 # Working with Outlook API
 
 The list of supported APIs:

{Office365-REST-Python-Client-2.5.3 → Office365-REST-Python-Client-2.5.4}/Office365_REST_Python_Client.egg-info/SOURCES.txt

@@ -549,6 +549,7 @@ office365/onedrive/workbooks/functions/__init__.py
 office365/onedrive/workbooks/functions/functions.py
 office365/onedrive/workbooks/functions/result.py
 office365/onedrive/workbooks/names/__init__.py
+office365/onedrive/workbooks/names/collection.py
 office365/onedrive/workbooks/names/named_item.py
 office365/onedrive/workbooks/operations/__init__.py
 office365/onedrive/workbooks/operations/error.py

{Office365-REST-Python-Client-2.5.3/Office365_REST_Python_Client.egg-info → Office365-REST-Python-Client-2.5.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: Office365-REST-Python-Client
-Version: 2.5.3
+Version: 2.5.4
 Summary: Microsoft 365 & Microsoft Graph Library for Python
 Home-page: https://github.com/vgrem/Office365-REST-Python-Client
 Author: Vadim Gremyachev
@@ -58,7 +58,6 @@ pip install Office365-REST-Python-Client
 
 ### Note 
 >
-
 >Alternatively the _latest_ version could be directly installed via GitHub:
 >```
 >pip install git+https://github.com/vgrem/Office365-REST-Python-Client.git
@@ -206,6 +205,20 @@ The list of examples:
   
 Refer [examples section](examples/sharepoint) for another scenarios
 
+### Support for non-standard SharePoint Online Environments
+
+  Support for non-standard SharePoint Environments is currently being implemented. Currently supported:
+  - GCC High
+
+  To enable authentication to GCC High endpoints, add the `environment='GCCH'` parameter when calling the 
+  `ClientContext class` with `.with_user_credentials`, `.with_client_credentials`, or `.with_credentials`
+
+   Example:
+   ```python
+   client_credentials = ClientCredential('{client_id}','{client_secret}')
+   ctx = ClientContext('{url}').with_credentials(client_credentials, environment='GCCH')
+   ```
+
 # Working with Outlook API
 
 The list of supported APIs:

{Office365-REST-Python-Client-2.5.3 → Office365-REST-Python-Client-2.5.4}/README.md

@@ -27,7 +27,6 @@ pip install Office365-REST-Python-Client
 
 ### Note 
 >
-
 >Alternatively the _latest_ version could be directly installed via GitHub:
 >```
 >pip install git+https://github.com/vgrem/Office365-REST-Python-Client.git
@@ -175,6 +174,20 @@ The list of examples:
   
 Refer [examples section](examples/sharepoint) for another scenarios
 
+### Support for non-standard SharePoint Online Environments
+
+  Support for non-standard SharePoint Environments is currently being implemented. Currently supported:
+  - GCC High
+
+  To enable authentication to GCC High endpoints, add the `environment='GCCH'` parameter when calling the 
+  `ClientContext class` with `.with_user_credentials`, `.with_client_credentials`, or `.with_credentials`
+
+   Example:
+   ```python
+   client_credentials = ClientCredential('{client_id}','{client_secret}')
+   ctx = ClientContext('{url}').with_credentials(client_credentials, environment='GCCH')
+   ```
+
 # Working with Outlook API
 
 The list of supported APIs:

{Office365-REST-Python-Client-2.5.3 → Office365-REST-Python-Client-2.5.4}/office365/directory/applications/template.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.entity import Entity
 from office365.runtime.client_result import ClientResult
 from office365.runtime.queries.service_operation import ServiceOperationQuery
@@ -25,11 +27,8 @@ class ApplicationTemplate(Entity):
 
     @property
     def display_name(self):
-        """
-        The name of the application.
-
-        :rtype: str or None
-        """
+        # type: () -> Optional[str]
+        """The name of the application."""
         return self.properties.get("displayName", None)
 
     @property
@@ -44,9 +43,7 @@ class ApplicationTemplate(Entity):
 
     @property
     def supported_provisioning_types(self):
-        """
-        The list of provisioning modes supported by this application
-        """
+        """The list of provisioning modes supported by this application"""
         return self.properties.get("supportedProvisioningTypes", StringCollection())
 
     @property

{Office365-REST-Python-Client-2.5.3 → Office365-REST-Python-Client-2.5.4}/office365/directory/authentication/methods/email.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.directory.authentication.methods.method import AuthenticationMethod
 
 
@@ -9,8 +11,6 @@ class EmailAuthenticationMethod(AuthenticationMethod):
 
     @property
     def email_address(self):
-        """
-        The email address registered to this user.
-        :rtype: str
-        """
+        # type: () -> Optional[str]
+        """The email address registered to this user."""
         return self.properties.get("emailAddress", None)

{Office365-REST-Python-Client-2.5.3 → Office365-REST-Python-Client-2.5.4}/office365/directory/protection/riskyusers/history_item.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 from office365.directory.protection.riskyusers.activity import RiskUserActivity
 from office365.directory.protection.riskyusers.risky_user import RiskyUser
 
@@ -13,7 +15,6 @@ class RiskyUserHistoryItem(RiskyUser):
 
     @property
     def initiated_by(self):
-        """The ID of actor that does the operation.
-        :rtype: str
-        """
+        # type: () -> Optional[str]
+        """The ID of actor that does the operation."""
         return self.properties.get("initiatedBy", None)

{Office365-REST-Python-Client-2.5.3 → Office365-REST-Python-Client-2.5.4}/office365/onedrive/driveitems/driveItem.py

@@ -795,6 +795,12 @@ class DriveItem(BaseItem):
             ),
         )
 
+    def set_property(self, name, value, persist_changes=True):
+        super(DriveItem, self).set_property(name, value, persist_changes)
+        if name == "parentReference":
+            self._resource_path.parent.patch(self.parent_reference.driveId)
+        return self
+
     def get_property(self, name, default_value=None):
         # type: (str, P_T) -> P_T
         if default_value is None:

{Office365-REST-Python-Client-2.5.3 → Office365-REST-Python-Client-2.5.4}/office365/onedrive/internal/paths/shared.py

@@ -1,22 +1,27 @@
 import base64
 
 from office365.runtime.paths.resource_path import ResourcePath
+from office365.runtime.paths.v4.entity import EntityPath
 
 
 def _url_to_shared_token(url):
-    """
-    Converts url into shared token
-    :param str url:
-    """
+    # type: (str) -> str
+    """Converts url into shared token"""
     value = base64.b64encode(url.encode("ascii")).decode("ascii")
     if value.endswith("="):
         value = value[:-1]
     return "u!" + value.replace("/", "_").replace("+", "-")
 
 
-class SharedPath(ResourcePath):
+class SharedPath(EntityPath):
     """Shared token path"""
 
+    def patch(self, key):
+        self._key = "items"
+        self._parent = ResourcePath(key, ResourcePath("drives"))
+        self.__class__ = ResourcePath
+        return self
+
     @property
     def segment(self):
         return _url_to_shared_token(self._key)

{Office365-REST-Python-Client-2.5.3 → Office365-REST-Python-Client-2.5.4}/office365/onedrive/shares/drive_item.py

@@ -8,6 +8,7 @@ from office365.onedrive.lists.list import List
 from office365.onedrive.permissions.permission import Permission
 from office365.onedrive.sites.site import Site
 from office365.runtime.paths.resource_path import ResourcePath
+from office365.runtime.paths.v4.entity import EntityPath
 
 
 class SharedDriveItem(BaseItem):
@@ -47,7 +48,7 @@ class SharedDriveItem(BaseItem):
         """Used to access the underlying driveItem"""
         return self.properties.get(
             "driveItem",
-            DriveItem(self.context, ResourcePath("driveItem", self.resource_path)),
+            DriveItem(self.context, EntityPath("driveItem", self.resource_path)),
         )
 
     @property

{Office365-REST-Python-Client-2.5.3 → Office365-REST-Python-Client-2.5.4}/office365/onedrive/versions/drive_item.py

@@ -1,4 +1,4 @@
-from typing import Optional
+from typing import AnyStr, Optional
 
 from office365.onedrive.versions.base_item import BaseItemVersion
 from office365.runtime.queries.service_operation import ServiceOperationQuery
@@ -17,16 +17,12 @@ class DriveItemVersion(BaseItemVersion):
 
     @property
     def content(self):
-        """
-        The content stream for this version of the item.
-        :rtype: str or bytes
-        """
+        # type: () -> Optional[AnyStr]
+        """The content stream for this version of the item."""
         return self.properties.get("content", None)
 
     @property
     def size(self):
         # type: () -> Optional[int]
-        """
-        Indicates the size of the content stream for this version of the item.
-        """
+        """Indicates the size of the content stream for this version of the item."""
         return self.properties.get("size", None)

{Office365-REST-Python-Client-2.5.3 → Office365-REST-Python-Client-2.5.4}/office365/onedrive/workbooks/functions/result.py

@@ -4,4 +4,4 @@ from office365.entity import Entity
 class WorkbookFunctionResult(Entity):
     @property
     def value(self):
-        return self.properties.get("__value", None)
+        return self.properties.get("value", None)

Office365-REST-Python-Client-2.5.4/office365/onedrive/workbooks/names/collection.py

@@ -0,0 +1,26 @@
+from office365.entity_collection import EntityCollection
+from office365.onedrive.workbooks.names.named_item import WorkbookNamedItem
+from office365.runtime.queries.service_operation import ServiceOperationQuery
+
+
+class WorkbookNamedItemCollection(EntityCollection[WorkbookNamedItem]):
+    def __init__(self, context, resource_path=None):
+        super(WorkbookNamedItemCollection, self).__init__(
+            context, WorkbookNamedItem, resource_path
+        )
+
+    def add(self, name, reference, comment=None):
+        """
+        Adds a new name to the collection of the given scope using the user's locale for the formula.
+
+        :param str name: The name of the object.
+        :param str reference: Represents the formula that the name is defined to refer to.
+             For example, =Sheet14!$B$2:$H$12, =4.75,
+        :param str comment: Represents the comment associated with this name.
+        """
+        return_type = WorkbookNamedItem(self.context)
+        self.add_child(return_type)
+        payload = {"name": name, "reference": reference, "comment": comment}
+        qry = ServiceOperationQuery(self, "add", None, payload, None, return_type)
+        self.context.add_query(qry)
+        return return_type

{Office365-REST-Python-Client-2.5.3 → Office365-REST-Python-Client-2.5.4}/office365/onedrive/workbooks/names/named_item.py

@@ -1,5 +1,9 @@
+from typing import Optional
+
 from office365.entity import Entity
+from office365.onedrive.workbooks.ranges.range import WorkbookRange
 from office365.runtime.paths.resource_path import ResourcePath
+from office365.runtime.queries.function import FunctionQuery
 
 
 class WorkbookNamedItem(Entity):
@@ -7,18 +11,26 @@ class WorkbookNamedItem(Entity):
     (as seen in the type below), range object, reference to a range. This object can be used to obtain range
     object associated with names."""
 
+    def range(self):
+        """Returns the range object that is associated with the name. Throws an exception if the named item's type
+        isn't a range."""
+        return_type = WorkbookRange(
+            self.context, ResourcePath("range", self.resource_path)
+        )
+        qry = FunctionQuery(self, "range", return_type=return_type)
+        self.context.add_query(qry)
+        return return_type
+
     @property
     def name(self):
-        """The name of the object. Read-only.
-        :rtype str or None
-        """
+        # type: () -> Optional[str]
+        """The name of the object."""
         return self.properties.get("name", None)
 
     @property
     def comment(self):
-        """Represents the comment associated with this name.
-        :rtype str or None
-        """
+        # type: () -> Optional[str]
+        """Represents the comment associated with this name."""
         return self.properties.get("comment", None)
 
     @property
@@ -33,3 +45,8 @@ class WorkbookNamedItem(Entity):
                 self.context, ResourcePath("worksheet", self.resource_path)
             ),
         )
+
+    @property
+    def property_ref_name(self):
+        # type: () -> str
+        return "name"

{Office365-REST-Python-Client-2.5.3 → Office365-REST-Python-Client-2.5.4}/office365/onedrive/workbooks/ranges/range.py

@@ -1,4 +1,4 @@
-from typing import Optional
+from typing import List, Optional
 
 from office365.entity import Entity
 from office365.onedrive.workbooks.ranges.format import WorkbookRangeFormat
@@ -6,13 +6,50 @@ from office365.onedrive.workbooks.ranges.sort import WorkbookRangeSort
 from office365.onedrive.workbooks.ranges.view import WorkbookRangeView
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.runtime.queries.function import FunctionQuery
+from office365.runtime.queries.service_operation import ServiceOperationQuery
 
 
 class WorkbookRange(Entity):
     """Range represents a set of one or more contiguous cells such as a cell, a row, a column, block of cells, etc."""
 
+    def cell(self, row, column):
+        """
+        Gets the range object containing the single cell based on row and column numbers. The cell can be outside
+        the bounds of its parent range, so long as it's stays within the worksheet grid.
+        :param int row: Row number of the cell to be retrieved. Zero-indexed.
+        :param int column: Column number of the cell to be retrieved. Zero-indexed.
+        """
+        return_type = WorkbookRange(self.context)
+        params = {"row": row, "column": column}
+        qry = FunctionQuery(self, "cell", params, return_type=return_type)
+        self.context.add_query(qry)
+        return return_type
+
+    def clear(self, apply_to=None):
+        """Clear range values such as format, fill, and border.
+        :param str apply_to:
+        """
+        payload = {"applyTo": apply_to}
+        qry = ServiceOperationQuery(self, "clear", parameters_type=payload)
+        self.context.add_query(qry)
+        return self
+
+    def insert(self, shift):
+        """
+        Inserts a cell or a range of cells into the worksheet in place of this range, and shifts the other cells to
+        make space. Returns a new Range object at the now blank space.
+        :param str shift: Specifies which way to shift the cells. The possible values are: Down, Right.
+        """
+        return_type = WorkbookRange(self.context)
+        payload = {"shift": shift}
+        qry = ServiceOperationQuery(
+            self, "insert", parameters_type=payload, return_type=return_type
+        )
+        self.context.add_query(qry)
+        return return_type
+
     def visible_view(self):
-        """"""
+        """Get the range visible from a filtered range."""
         return_type = WorkbookRangeView(self.context)
         qry = FunctionQuery(self, "visibleView", return_type=return_type)
         self.context.add_query(qry)
@@ -63,6 +100,20 @@ class WorkbookRange(Entity):
             WorkbookRangeSort(self.context, ResourcePath("sort", self.resource_path)),
         )
 
+    @property
+    def values(self):
+        # type: () -> List
+        """Represents the raw values of the specified range. The data returned could be of type string, number,
+        or a boolean. Cell that contains an error returns the error string."""
+        return self.properties.get("values", None)
+
+    @property
+    def value_types(self):
+        # type: () -> List
+        """Represents the type of data of each cell. The possible values are:
+        Unknown, Empty, String, Integer, Double, Boolean, Error."""
+        return self.properties.get("valueTypes", None)
+
     @property
     def worksheet(self):
         """The worksheet containing the current range"""

{Office365-REST-Python-Client-2.5.3 → Office365-REST-Python-Client-2.5.4}/office365/onedrive/workbooks/tables/table.py

@@ -16,16 +16,23 @@ from office365.runtime.queries.service_operation import ServiceOperationQuery
 class WorkbookTable(Entity):
     """Represents an Excel table."""
 
+    def __repr__(self):
+        return self.name or self.id or self.entity_type_name
+
     def data_body_range(self):
         """Gets the range object associated with the data body of the table."""
-        return_type = WorkbookRange(self.context)
+        return_type = WorkbookRange(
+            self.context, ResourcePath("dataBodyRange", self.resource_path)
+        )
         qry = FunctionQuery(self, "dataBodyRange", return_type=return_type)
         self.context.add_query(qry)
         return return_type
 
     def range(self):
         """Get the range object associated with the entire table."""
-        return_type = WorkbookRange(self.context)
+        return_type = WorkbookRange(
+            self.context, ResourcePath("range", self.resource_path)
+        )
         qry = FunctionQuery(self, "range", return_type=return_type)
         self.context.add_query(qry)
         return return_type
@@ -58,9 +65,7 @@ class WorkbookTable(Entity):
     @property
     def columns(self):
         # type: () -> WorkbookTableColumnCollection
-        """
-        Represents a collection of all the columns in the table.
-        """
+        """Represents a collection of all the columns in the table."""
         return self.properties.get(
             "columns",
             WorkbookTableColumnCollection(

{Office365-REST-Python-Client-2.5.3 → Office365-REST-Python-Client-2.5.4}/office365/onedrive/workbooks/workbook.py

@@ -3,7 +3,7 @@ from office365.entity_collection import EntityCollection
 from office365.onedrive.workbooks.applications.application import WorkbookApplication
 from office365.onedrive.workbooks.comments.comment import WorkbookComment
 from office365.onedrive.workbooks.functions.functions import WorkbookFunctions
-from office365.onedrive.workbooks.names.named_item import WorkbookNamedItem
+from office365.onedrive.workbooks.names.collection import WorkbookNamedItemCollection
 from office365.onedrive.workbooks.operations.workbook import WorkbookOperation
 from office365.onedrive.workbooks.session_info import WorkbookSessionInfo
 from office365.onedrive.workbooks.tables.collection import WorkbookTableCollection
@@ -11,6 +11,7 @@ from office365.onedrive.workbooks.worksheets.collection import (
     WorkbookWorksheetCollection,
 )
 from office365.runtime.client_result import ClientResult
+from office365.runtime.http.request_options import RequestOptions
 from office365.runtime.paths.resource_path import ResourcePath
 from office365.runtime.queries.function import FunctionQuery
 from office365.runtime.queries.service_operation import ServiceOperationQuery
@@ -56,9 +57,7 @@ class Workbook(Entity):
         self.context.add_query(qry)
 
         def _construct_request(request):
-            """
-            :type request: office365.runtime.http.request_options.RequestOptions
-            """
+            # type: (RequestOptions) -> None
             request.set_header("workbook-session-id", session_id)
 
         self.context.before_execute(_construct_request)
@@ -66,15 +65,12 @@ class Workbook(Entity):
 
     def close_session(self, session_id):
         """Use this API to close an existing workbook session.
-
         :param str session_id: Identifier of the workbook session
         """
         qry = ServiceOperationQuery(self, "closeSession")
 
         def _construct_request(request):
-            """
-            :type request: office365.runtime.http.request_options.RequestOptions
-            """
+            # type: (RequestOptions) -> None
             request.set_header("workbook-session-id", session_id)
 
         self.context.before_execute(_construct_request)
@@ -93,6 +89,7 @@ class Workbook(Entity):
 
     @property
     def comments(self):
+        # type: () -> EntityCollection[WorkbookComment]
         """"""
         return self.properties.get(
             "comments",
@@ -126,13 +123,12 @@ class Workbook(Entity):
 
     @property
     def names(self):
-        # type: () -> EntityCollection[WorkbookNamedItem]
+        # type: () -> WorkbookNamedItemCollection
         """Represents a collection of workbook scoped named items (named ranges and constants). Read-only."""
         return self.properties.get(
             "names",
-            EntityCollection(
+            WorkbookNamedItemCollection(
                 self.context,
-                WorkbookNamedItem,
                 ResourcePath("names", self.resource_path),
             ),
         )

{Office365-REST-Python-Client-2.5.3 → Office365-REST-Python-Client-2.5.4}/office365/outlook/item.py

@@ -1,4 +1,5 @@
 import datetime
+from typing import Optional
 
 from office365.entity import Entity
 from office365.runtime.types.collections import StringCollection
@@ -7,18 +8,16 @@ from office365.runtime.types.collections import StringCollection
 class OutlookItem(Entity):
     @property
     def change_key(self):
+        # type: () -> Optional[str]
         """
         Identifies the version of the item. Every time the item is changed, changeKey changes as well.
         This allows Exchange to apply changes to the correct version of the object.
-        :rtype: str
         """
         return self.properties.get("ChangeKey", None)
 
     @property
     def categories(self):
-        """
-        The categories associated with the item
-        """
+        """The categories associated with the item"""
         return self.properties.get("categories", StringCollection())
 
     @property

{Office365-REST-Python-Client-2.5.3 → Office365-REST-Python-Client-2.5.4}/office365/runtime/auth/authentication_context.py

@@ -173,8 +173,9 @@ class AuthenticationContext(object):
         :param UserCredential or ClientCredential credentials:
         """
         if isinstance(credentials, ClientCredential):
+            environment = kwargs.get("environment")
             provider = ACSTokenProvider(
-                self.url, credentials.clientId, credentials.clientSecret
+                self.url, credentials.clientId, credentials.clientSecret, environment
             )
         elif isinstance(credentials, UserCredential):
             allow_ntlm = kwargs.get("allow_ntlm", False)
@@ -184,8 +185,9 @@ class AuthenticationContext(object):
                 provider = NtlmProvider(credentials.userName, credentials.password)
             else:
                 browser_mode = kwargs.get("browser_mode", False)
+                environment = kwargs.get("environment")
                 provider = SamlTokenProvider(
-                    self.url, credentials.userName, credentials.password, browser_mode
+                    self.url, credentials.userName, credentials.password, browser_mode, environment
                 )
         else:
             raise ValueError("Unknown credential type")

{Office365-REST-Python-Client-2.5.3 → Office365-REST-Python-Client-2.5.4}/office365/runtime/auth/providers/acs_token_provider.py

@@ -10,13 +10,15 @@ from office365.runtime.http.request_options import RequestOptions
 
 
 class ACSTokenProvider(AuthenticationProvider, office365.logger.LoggerContext):
-    def __init__(self, url, client_id, client_secret):
+    def __init__(self, url, client_id, client_secret, environment='commercial'):
         """
         Provider to acquire the access token from a Microsoft Azure Access Control Service (ACS)
 
         :param str client_id: The OAuth client id of the calling application.
         :param str client_secret: Secret string that the application uses to prove its identity when requesting a token
         :param str url: SharePoint web or site url
+        :param str environment: The Office 365 Cloud Environment endpoint used for authentication
+            defaults to 'commercial'.
         """
         self.url = url
         self.redirect_url = None
@@ -25,6 +27,7 @@ class ACSTokenProvider(AuthenticationProvider, office365.logger.LoggerContext):
         self._client_id = client_id
         self._client_secret = client_secret
         self._cached_token = None
+        self._environment = environment
 
     def authenticate_request(self, request):
         # type: (RequestOptions) -> None
@@ -62,7 +65,7 @@ class ACSTokenProvider(AuthenticationProvider, office365.logger.LoggerContext):
             self.SharePointPrincipal, target_host, target_realm
         )
         principal_id = self.get_formatted_principal(self._client_id, None, target_realm)
-        sts_url = self.get_security_token_service_url(target_realm)
+        sts_url = self.get_security_token_service_url(target_realm, environment=self._environment)
         oauth2_request = {
             "grant_type": "client_credentials",
             "client_id": principal_id,
@@ -101,10 +104,15 @@ class ACSTokenProvider(AuthenticationProvider, office365.logger.LoggerContext):
         return "{0}@{1}".format(principal_name, realm)
 
     @staticmethod
-    def get_security_token_service_url(realm):
-        return "https://accounts.accesscontrol.windows.net/{0}/tokens/OAuth/2".format(
-            realm
-        )
+    def get_security_token_service_url(realm, environment):
+        if environment == "GCCH":
+            return "https://login.microsoftonline.us/{0}/tokens/OAuth/2".format(
+                realm
+            )
+        else:
+            return "https://accounts.accesscontrol.windows.net/{0}/tokens/OAuth/2".format(
+                realm
+            )
 
     def _get_authorization_header(self):
         return "Bearer {0}".format(self._cached_token.accessToken)