You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+32-16
Original file line number
Diff line number
Diff line change
@@ -23,15 +23,15 @@ Deploying MATLAB Web App Server on Azure automatically deploys a network license
23
23
To deploy the reference architecture, select your MATLAB Web App Server release from the table and follow the instructions to deploy the server using the provided template.
> \*When the server is configured to use MATLAB Runtime versions prior to R2023b, the `unsafe-inline` attribute is set in the `script-src` directive of the server's Content Security Policy on the server and cannot be removed. The attribute allows inline JavaScript execution and event handlers contained within a web app to execute on the server. These runtimes are disabled by default in R2024b. You can enable them using the [webapps-runtime](https://www.mathworks.com/help/webappserver/ref/webappsruntime.html) command.
34
+
> \*When the server is configured to use MATLAB Runtime versions prior to R2023b, the `unsafe-inline` attribute is set in the `script-src` directive of the server's Content Security Policy on the server and cannot be removed. The attribute allows inline JavaScript execution and event handlers contained within a web app to execute on the server. These runtimes are disabled by default starting in R2024b. You can enable them using the [webapps-runtime](https://www.mathworks.com/help/webappserver/ref/webappsruntime.html) command.
35
35
36
36
MathWorks provides templates for only the six most recent releases of MATLAB Web App Server. Earlier templates are removed and are no longer supported.
37
37
@@ -68,35 +68,51 @@ If you are deploying a new network license manager, the following resources will
68
68
# FAQ
69
69
## How do I deploy to an existing virtual network?
70
70
>**Note:** Your existing virtual network must have at least two available subnets for deployment.
71
-
1. To deploy MATLAB Web App Server to an existing virtual network, set the **Deploy to New or Existing Virtual Network** paratmeter to `existing`.
72
-
1. Set the following parameter values in the template based on your existing virtual network and open the ports listed below.
|**Resource Group Name of Virtual Network**| Specify the name of the Azure resource group that has your existing virtual network. |
77
-
|**Name of Virtual Network Where MATLAB Web App Server Will Be Deployed**| Specify the name of the existing virtual network where the server will be deployed. |
|**Specify Private IP Address to VM Hosting MATLAB Web App Server**| Specify a private IP address to the VM hosting the server. For example: 10.0.0.4 . |
82
-
83
-
### **Ports to Open in Existing Virtual Network**
84
71
72
+
### Ports to Open in Existing Virtual Network
73
+
If you are deploying MATLAB Web App Server to an existing virtual network, you must open the following ports in your virtual network:
|`443`| HTTPS - the port Web App Server will service if SSL is enabled |
88
77
|`22`| SSH - used for remoting into Linux machines |
89
78
|`3389`| RDP - used for remoting into Windows machines |
90
79
|`27000`| Required for communication between network license manager and Web App Server |
91
80
81
+
### Create Service Endpoint in Virtual Network (Since R2025a)
82
+
Starting in R2025a, if you are using an existing virtual network and assign a public IP address to the VM hosting MATLAB Web App Server, then you must manually add a service endpoint to the virtual network *before* deploying MATLAB Web App Server in order to create and access the storage account. For more details, see [Grant access from a virtual network](https://learn.microsoft.com/en-us/azure/storage/common/storage-network-security?tabs=azure-portal#grant-access-from-a-virtual-network) in the Microsoft Azure documentation.
83
+
84
+
You can check if such an endpoint already exists by navigating to the Azure Portal, selecting your virtual network, and clicking **Service endpoints**. If no such endpoint is present, follow these steps:
85
+
1. In the Azure Portal, click **Resource groups** and select the virtual network for this deployment.
86
+
1. In the left navigation menu, expand the **Settings** category and click **Service endpoints**.
87
+
1. Click **Add** to add the new endpoint. It must have the following parameters:
<tr><td><b>Subnet</b></td><td>Name of subnet in which the storage account will be deployed</td></tr>
92
+
</table>
92
93
94
+
For more information on creating endpoints, see [Create and associate service endpoint policies](https://learn.microsoft.com/en-us/azure/virtual-network/virtual-network-service-endpoint-policies).
95
+
96
+
### Deploy to Existing Virtual Network
97
+
To deploy MATLAB Web App Server to an existing virtual network, in the deployment template, set the **Deploy to New or Existing Virtual Network** parameter to `existing`.
98
+
99
+
Set the following parameter values in the template based on your existing virtual network.
100
+
101
+
| Parameter Name | Value |
102
+
|-------------------|-----------|
103
+
|**Resource Group Name of Virtual Network**| Specify the name of the Azure resource group that has your existing virtual network. |
104
+
|**Name of Virtual Network Where MATLAB Web App Server Will Be Deployed**| Specify the name of the existing virtual network where the server will be deployed. |
|**Specify Private IP Address to VM Hosting MATLAB Web App Server**| Specify a private IP address to the VM hosting the server. For example: 10.0.0.4 . |
93
109
94
110
## How do I configure OIDC authentication?
95
111
1. To use OIDC authentication on the server, you need to register with an IdP such as Microsoft® Azure® AD, or Google® Identity Platform. MATLAB Web App Server must be registered as an application with the IdP.
96
112
1. During the registration process, you need a redirect URL for MATLAB Web App Server. The format of the URL is: `https://<MATLABWebAppServer_hostname>:<port_server_is_running_on>/webapps/extauth/callback`. For example: `https://example.com:9988/webapps/extauth/callback`.
97
113
1. Create a file named `webapps_authn.json` using the JSON schema specified [here](https://www.mathworks.com/help/webappserver/ug/authentication.html#mw_908077ba-725e-4cc9-a906-a1bf29fceaf8) and place it in the `webapps_private` folder of the server. For folder location, see the [doc](https://www.mathworks.com/help/webappserver/ug/authentication.html#mw_146e67b0-5dff-4310-8d5d-544250e931a9).
98
114
1. To place the `webapps_authn.json` file in the `webapps_private` folder of the server, you need to remotely connect to the server using RDP on Windows or SCP on Linux. Once connected, you can drag-and-drop the `webapps_authn.json` file you created into the `webapps_private` folder of the server. Alternatively, you can drop the file into the file share first, before moving it to the `webapps_private` folder.
99
-
1. Restart the server by executing `webapps-restart` from a terminal on the the server machine. The `webapps-restart` command is located in the `script` folder within the default installation location. For default location, see the [doc](https://www.mathworks.com/help/webappserver/ug/set-up-matlab-web-app-server.html#responsive_offcanvas).
115
+
1. Restart the server by executing `webapps-restart` from a terminal on the server machine. The `webapps-restart` command is located in the `script` folder within the default installation location. For default location, see the [doc](https://www.mathworks.com/help/webappserver/ug/set-up-matlab-web-app-server.html#responsive_offcanvas).
100
116
101
117
## How do I remotely connect to the server virtual machine?
0 commit comments