Location Restriction for Office 365

2. Configure Office 365 in miniOrange

• Login into miniOrange Admin Console.
• Go to Apps and click on Add Application button.



• In Choose Application Type click on Create App button in SAML/WS-FED application type.



• In the next step, search for Office 365. Click on Office 365 app.



• Make sure the SP Entity ID or Issuer is: urn:federation:MicrosoftOnline
• Make sure the ACS URL is: https://login.microsoftonline.com/login.srf
• Click on Next.



• Configure Name ID based on the User Store you are using:
  • Using Active Directory / miniOrange brokering service: Select External IDP Attribute from the dropdown and add objectguid in the text-box that appears.
  
  • Using miniOrange as a User Store: Select Custom Profile Attribute and select a Custom Attribute from the drop-down.
  
• Set the login policy. You can choose to enable 2FA for login or have users login using a standard username-password.
• Click on Save to configure Office 365.

3. Configure Microsoft Online Services

• Click on Select dropdown and choose Metadata.
  



• Click on the Download Federate Domain Script button under "INFORMATION REQUIRED TO AUTHENTICATE VIA EXTERNAL IDPS"



• Enter the domain name that you want to federate and click on Download. Note: You cannot federate your default "onmicrosoft.com" domain. To federate your Office 365 tenant, you must add a custom domain to Office 365.



• After downloading the script, Open PowerShell run the federate_domain script using: cd ./Downloads powershell -ExecutionPolicy ByPass -File federate_domain.ps1



• Your domain is now federated. Use the commands below to check your federation settings: Connect-MsolService Get-MsolDomainFederationService

4. Configure Location Restriction: Restricting access by Limiting the number of locations

In this restriction method, admin configures a list of locations where we want to allow end-users to either login or deny based on the condition set by the admin. When a user tries to login with adaptive authentication enabled, his Location Attributes such as (Latitude, Longitude and Country Code) are verified against the Location list configured by the admin. And based on this user will be either allowed, challenged or denied.

• Go to Adaptive Authentication from the left navigation bar.
• Click on Add Policy tab.



• Add a Policy Name for your Adaptive Authentication Policy.



• Scroll down to Location Configuration section and click on Edit.



• Here, you can Enable Location Registration if User Completes Challenge.
• Under Configured Locations, click on Add Location.



• In the Enter Location input field, enter the Location Name and then select the correct location from the search results dropdown. Next, select your distance parameter as either KMS(KiloMeters) or Miles under Allowed Radius. For each Location you add, you can choose to either whitelist/allow or blacklist/deny it by selecting the suitable option.
• You can click on the Add Location to add more than one location and then follow steps as mentioned above.



• Now, scroll down to the Action For Behaviour Change section and click on Edit. Select the action you want to perform if the IP address is out of the range. i.e. Allow, Challenge or Deny.



• Scroll to the end and click on save.

5. Enable Restriction for Office 365

• Go to Policies >> App Login Policy from the left navigation bar.
• Click on Edit option against your selected app.



• Set your application name in the Application and select password as Login Method.
• Enable Adaptive Authentication.
• From the Select Login Policy dropdown, select the policy we created in the last step and select the required restriction method as an option.
• Click Save.

2. Configure authentication source in CASB

• Sign in to the Cloud Access Security Broker (CASB) with your email and password. (Don't have an account? No worries, click here to create a new account)



• After signing in, navigate to the Authentication Source in the left sidebar.



• You will see the list of all existing authentication sources configured in the CASB dashboard. Click on Add New to create a new one.



• This will open the configuration screen for the Authentication Source. Enter the Authentication Source Name and click Download Metadata.

3. Configure Microsoft Office 365 as a Identity Provider

• Go to miniOrange IDP and click on the User Profile Fields as shown below in the image and click on it.
  (In this guide, we are using miniOrange as the IDP, but you can contact us at proxysupport@xecurify.com to set up your preferred IDP.)



• Click on the Add Custom Profile Attribute button.



• Enter Field Name as Guid and Field Type as Textbox (select from dropdown). Click on save button.



• This will create a custom attribute field as Guid as shown below in the image which will be used to sync the ImmutableID for the users.



• Now navigate to the Apps and click on the Add Application button .



• Search for the Office 365 in the search box and click on it.



• Here, give the name of your application and go to Attribute Mapping. This application will be used to sync users from miniOrange IAM to Office 365.



• On the Attribute Mappings:
  • In NameID, select the Custom Attribute from the 1st dropdown.
  • Now select Guid over the 2nd dropdown (which we created in the previous step).



• Now navigate to the last tab Provisioning, enter your domain, and click on the Save button.



• Navigate to the newly created application and under the Actions column, click on the Edit button as shown below.



• It will open the Edit view of the application. Over there, go to Provisioning.



• Click on the Verify Microsoft Administrator button.



• It will take you to the Microsoft login page. Log in with your Admin Credentials for your Microsoft account.



• Once you are logged in with the admin user, it will show you the page below. Click on the Accept button.



• Now go to Provisioning on the sidebar and in the Select Application dropdown, choose Office 365 / Azure AD.



• Keep the Attribute section with the values shown in the image below, enable the required Provisioning Features, and click on Save once you are done.

Microsft Attributes	miniOrange Attributes
givenName	First Name
surname	Last Name
mailnickname	Username
userprincipalname	Email Address




• Now go to the Apps on the sidebar and click on Add Application.



• Search for Custom SAML App and click on it.



• Click on the Import SP Metadata button as shown below.



• Provide a name for your Office-365 Authentication application, choose the File option, upload the file downloaded in step 1, and click on Import.



• This step will import the metadata for SAML Authentication. Now go to the Attribute Mapping section.



• In the Attribute Mapping, make the following configurations and click on the Save button:
  • NameID → Select the Custom Profile Attribute from the 1st dropdown and select Guid from the 2nd dropdown.
  • Click on Add Attribute button as shown below in the 3rd.
• Group Attribute Mapping:
  • Attribute Name → groups
  • Attribute Value → User Groups (select from dropdown)
• Name Attribute Mapping:
  • Attribute Name → fname
  • Attribute Value → Full Name (select from dropdown)



• Navigate to the newly created application, click on the three dots under the Action column, and select the Metadata option.



• Copy the Metadata URL and return to the CASB Dashboard.



• On the CASB Dashboard, go to Authentications Source and click on the Upload Metadata option.



• Select Input Format as URL, paste the copied URL, and click on Import.



• A prompt will confirm that the metadata has been uploaded successfully. Click on the Save button to save the Authentication Source.

4. Configure Microsoft Office 365 in CASB

• Navigate to Applications on the sidebar, go to Office 365, and click on the Configure button.



• Select the Authentication Source from the dropdown that we created in the previous step, then click on Save and Next.



• Configure the following details and click on the Save button:

Application Name:	Enter the name of your application
Organization Domain:	Enter the domain of your organization. (Ex: example.com)
Attribute Key:	Enter the Group Attribute Key for the SSO app, which you have configured in the IDP under the SAML attributes section.
Name Attribute Key:	Enter the attribute name like fname,Lname etc.
Enter ACS URL:	Enter the office365 ACS URL as : https://login.microsoftonline.com/login.srf
Enter Entity URL:	Enter the office365 Entity URL as : urn:federation:MicrosoftOnline




• Once everything is configured, download the federation script.



• Note: Run the downloaded federation script using the following command:

powershell -ExecutionPolicy ByPass -File [Your File Name].ps1



• After running the command in Windows PowerShell, a pop-up will appear and Enter your Office365 Admin account credentials.



• Open your authenticator app and enter the displayed number to approve the sign-in request.



• The federation script successfully completed, as shown in the image below.

5. Configuring Policies and Groups

Let's see how to configure policies and groups for Office365 CASB.

• Go to Manage Policy screen and click on Add New button.



• Enter your policy details, like Policy Name and Policy Description.



• Click on Checkbox to enable the Location Restriction as shown in the image below.
• By enabling this feature, you are restricting access to users based on their Location:

1) Select the Allow or Deny option to either permit or restrict certain locations.

2) Select Locations from dropdown.

• Once done, click on Save button.



• Now, go to the Applications tab and click the Edit option for your application.



• Click on Group Settings and then click Add New button.



• Enter the Group Name and Group Description. Select the Office365 Policy from the drop-down menu.
• Choose the application to which you want to apply below permissions.

1) App Restriction: In this, the restrictions will be applied over the application based on the policy that you have configured for the group.

2) No App Restriction: In this, there will be no restrictions on the application for the group.

3) Disable App: By choosing this option, the application becomes inaccessible from anywhere for the entire group.

4) Custom App Restriction: By using this, you can apply an application-specific custom application restriction policy to an application that overpowers the group's restriction policy.




• Now, click on Save & Next button.