Endpoint Reference
Required Endpoints
The following table lists the required endpoints for using WikiTraccs.
Microsoft 365
| Required Endpoint | Purpose |
|---|---|
| login.microsoftonline.com | Authentication with Microsoft |
| aadcdn.msftauth.net | Authentication with Microsoft |
| login.live.com | Authentication with Microsoft |
| COMPANY.sharepoint.com | Access to SharePoint APIs (note: replace COMPANY with the value valid for your environment) |
| graph.microsoft.com | Access to Microsoft Graph API |
Atlassian Confluence REST API
WikiTraccs uses the REST endpoints of Confluence.
The REST endpoints are expected under the following URL:
<confluencebaseurl>/rest/api/(on-prem & cloud)<confluencebaseurl>/api/v2(cloud)
Highly Recommended Endpoints
The following endpoints should be made available to WikiTraccs for ease of use. If those endpoints are blocked, it will lead to:
- higher configuration effort
- repeated configuration effort
- reduced migration capabilities
Refer to the following article for information on the different endpoints and the consequences of blocking them: Locked-down environments.
Automatic Chrome WebDriver download
The Chrome WebDriver is used by WikiTraccs to show a browser window for Confluence authentication.
| Required Endpoint | Purpose | Owner info |
|---|---|---|
| chromedriver.chromium.org | Chrome WebDriver version detection | Whois registrant: Google LLC (CA, US) |
| chromedriver.storage.googleapis.com | Chrome WebDriver download | Whois registrant: Google LLC (CA, US) |
| googlechromelabs.github.io/chrome-for-testing/latest-patch-versions-per-build-with-downloads.json | Chrome WebDriver version information for Chrome starting with version 115 | Github-Repository owner: Google Chrome team |
| edgedl.me.gvt1.com | Host for Chrome WebDriver downloads | Whois registrant: Google LLC (CA, US) |
| storage.googleapis.com | Host for Chrome WebDriver downloads | Whois registrant: Google LLC (CA, US) |
Refer to the troubleshooting section, specificilly on how to manually work around the restrictions imposed by blocking endpoints.
Draw.io Endpoints
Refer to Prerequisites for Draw.io Preview Image Generation for information about endpoints related to Draw.io migration.
Optional Endpoints
Atlassian Confluence (On-Prem) XML-RPC
WikiTraccs uses the REST endpoints of Confluence with one exception.
There is one endpoint of the old XML-RPC API that is being used to read space permissions, since those are not available via the REST API. This endpoint is expected under the following URL:
<confluencebaseurl>/rpc/xmlrpc/
Space permissions are currently retrieved by WikiTraccs but not processed during the migration. It currently is no problem when this endpoint is not available, but data about space permissions might be missing when a future release of WikiTraccs starts working with them.