Skip to content

Commit bff3728

Browse files
authored
Merge pull request #3134 from MicrosoftDocs/crdun-mac-firewall
[mac] firewall/proxy rules
2 parents be0bfa3 + e203cfc commit bff3728

File tree

3 files changed

+93
-4
lines changed

3 files changed

+93
-4
lines changed

mac/TOC.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,8 @@
22
# [IDE Tour](ide-tour.md)
33

44
# [Installation](installation.md)
5-
## [Preview Installation](install-preview.md)
5+
## [Install and use behind a firewall or proxy](install-behind-a-firewall-or-proxy-server.md)
6+
## [Install a Preview release](install-preview.md)
67
## [Update](update.md)
78
## [Uninstall](uninstall.md)
89

Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
---
2+
title: "Install and use Visual Studio for Mac behind a firewall or proxy server"
3+
description: "This document provides a list of hosts that must be whitelisted in your firewall to allow Visual Studio for Mac (and its workloads, including Xamarin) to work in a corporate environment."
4+
ms.topic: troubleshooting
5+
ms.assetid: 79C0F1A3-0C13-4E55-A820-1138A4082B77
6+
author: asb3993
7+
ms.author: amburns
8+
ms.date: 10/23/2018
9+
---
10+
11+
# Install and use Visual Studio for Mac behind a firewall or proxy server
12+
13+
If you or your organization uses security measures such as a firewall or a proxy server, then there are domain URLs that you might want to "whitelist" and ports and protocols that you might want to open so that you have the best experience when you install and use Visual Studio for Mac and Azure Services.
14+
15+
- [**Install Visual Studio for Mac**](#install-visual-studio-for-mac): These tables include the URLs to whitelist so that you have access to all features and workloads of Visual Studio for Mac.
16+
17+
- [**Use Visual Studio for Mac**](#use-visual-studio-for-mac): These tables include URLs to whitelist so that you have access to all of the services and features that you want.
18+
19+
## Install Visual Studio for Mac
20+
21+
Because the Visual Studio for Mac Installer downloads from a various domains and download servers, here are the domains and URLs that you may want to add as trusted in your configurations.
22+
23+
### Microsoft domains
24+
25+
| Domain| Purpose |
26+
| ----------------------------------- |---------------------------|
27+
| *.live.com| Credential Management |
28+
| app.vssps.visualstudio.com| Installer Metadata|
29+
| vortex.data.microsoft.com | Crash and Error Reporting |
30+
| az667904.vo.msecnd.net| Crash and Error Reporting |
31+
| xamarin.com | Installer Metadata|
32+
| xampubdl.blob.core.windows.net| Installer Packages|
33+
| download.visualstudio.microsoft.com | Installer Packages|
34+
| xamarin.azureedge.net | Installer Packages|
35+
| developer.xamarin.com | Installer Packages|
36+
| dc.services.visualstudio.com| Crash Reporting |
37+
38+
### Third party domains
39+
40+
| Domain| Purpose |
41+
| --------------------------|-------------------------|
42+
| dl.google.com | Android SDK |
43+
| download.oracle.com | Java SDK|
44+
| api.apple-cloudkit.com| Apple Security Services |
45+
46+
## Use Visual Studio for Mac
47+
48+
To make sure that you have access to every feature that you need in Visual Studio for Mac while behind a proxy or firewall, we recommend whitelisting the following domains and ports.
49+
50+
### General
51+
52+
| Domain | Port(s)|Purpose|
53+
| ----------------------|------------------|------------------|
54+
| go.microsoft.com | 80/443|Microsoft URL Resolution |
55+
| vsstartpage.blob.core.windows.net| 80/443| Start Page Data|
56+
| software.xamarin.com | 80/443|Updater Service|
57+
| addins.monodevelop.com | 80/443| Extension Services |
58+
| visualstudio-devdiv-c2s.msedge.net | 80/443| Experimental Feature and Notifications |
59+
| targetednotifications.azurewebsites.net| 80/443| Used to filter a global list of notifications to a list that is applicable only to specific types of machines/usage scenarios|
60+
61+
### Identity
62+
63+
| Domain | Port(s)|Purpose|
64+
| ----------------------|------------------|------------------|
65+
| login.microsoftonline.com | 80/443| Identity Provider|
66+
| secure.aadcdn.microsoftonline-p.com | 80/443|Identity Provider|
67+
| dc.services.visualstudio.com| 80/443|Crash Reporting|
68+
| management.azure.com|80/443| Azure Services API |
69+
70+
### NuGet
71+
72+
| Domain | Port(s)|Purpose|
73+
| ----------------------|------------------|------------------|
74+
| api.nuget.org | 80/443|NuGet API|
75+
| secure.aadcdn.microsoftonline-p.com |80/443| Identity Provider|
76+
77+
### Android projects
78+
79+
| Domain| Purpose|
80+
| ------------------------------------|------------------------------------|
81+
| time.android.com| Time Server for Android Emulator |
82+
| connectivitycheck.gstatic.com | Connectivity for Android Emulator|
83+
| cloudconfig.googleapis.com| APIs for Android Emulator|
84+
85+
## See also
86+
87+
- [Install and use Visual Studio 2017 and Azure Services behind a firewall or proxy server](https://docs.microsoft.com/visualstudio/install/install-and-use-visual-studio-behind-a-firewall-or-proxy-server)
88+
- [Troubleshooting similar issues on Windows](https://docs.microsoft.com/visualstudio/install/troubleshooting-network-related-errors-in-visual-studio)

mac/install-preview.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Installing Preview releases"
2+
title: "Install a Preview release"
33
description: "Instructions for updating Visual Studio for Mac and accessing preview releases."
44
author: conceptdev
55
ms.author: crdun
@@ -9,9 +9,9 @@ ms.technology: vs-ide-install
99
ms.assetid: 0E1EF257-9DE4-4653-9DF4-805CE007A1A1
1010
---
1111

12-
# Installing Preview releases
12+
# Install a Preview release
1313

14-
Before a new version of Visual Studio for Mac is officially released, it's released as a preview. The preview release gives you a chance to try out new features and get the latest bug fixes before they are fully incorporated into the product.
14+
Before a new version of Visual Studio for Mac is officially released, it's available as a preview. The preview release gives you a chance to try out new features and get the latest bug fixes before they are fully incorporated into the product.
1515

1616
Preview releases to Visual Studio for Mac are distributed as an update, rather than through a separate download. Visual Studio for Mac has three updater channels, as described in the [update](update.md) article: Stable, Beta, and Alpha.
1717

0 commit comments

Comments
 (0)