From 1e6263d1af1de9059071456d743d126a8aebc0e9 Mon Sep 17 00:00:00 2001
From: Vijay Raghavan Aravamudhan <vraravam@users.noreply.github.com>
Date: Wed, 8 Sep 2021 23:00:36 +0530
Subject: Expose 'known certificate hosts' in ms teams and outlook to try to
 fix certificate expiry issue (#675)

---
 docs/backend_api.md | 48 ++++++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 44 insertions(+), 4 deletions(-)

(limited to 'docs/backend_api.md')

diff --git a/docs/backend_api.md b/docs/backend_api.md
index dd7d760..e4f07df 100644
--- a/docs/backend_api.md
+++ b/docs/backend_api.md
@@ -4,13 +4,14 @@ Provides a set of helper functions to integrate the recipe into [Ferdi](https://
 
 ## Ferdi Backend Class Methods
 
-* [validateUrl](#user-content-validateurl)
-* [overrideUserAgent](#user-content-overrideuseragent)
-* [modifyRequestHeaders](#user-content-modifyrequestheaders)
+* [validateUrl](#validateurl)
+* [overrideUserAgent](#overrideuseragent)
+* [modifyRequestHeaders](#modifyrequestheaders)
+* [knownCertificateHosts](#knownCertificateHosts)
 
 ## Events
 
-* [webview events](#user-content-events)
+* [webview events](#events)
 
 ### validateUrl(URL)
 
@@ -110,6 +111,45 @@ module.exports = Ferdi => class HangoutsChat extends Ferdi {
 };
 ```
 
+### knownCertificateHosts()
+
+Specify an array of known hosts from where certificates can be issued for this service
+
+#### Returns
+
+`Array` containing hostnames from where certificates can be issued
+
+#### Usage
+
+```js
+// msteams Chat integration
+module.exports = Ferdi => class MicrosoftTeams extends Ferdi {
+  knownCertificateHosts() {
+    return [
+      'aka.ms',
+      'aspnetcdn.com',
+      'azure.net',
+      'azureedge.net',
+      'live.com',
+      'microsoft.com',
+      'microsoftonline.com',
+      'msecnd.net',
+      'msedge.net',
+      'mstea.ms',
+      'office.net',
+      'okta.com',
+      'sfbassets.com',
+      'skype.com',
+      'skypeassets.com',
+      'skypeforbusiness.com',
+      'tenor.com',
+      'windows.com',
+      'windows.net',
+    ];
+  };
+};
+```
+
 ### Events
 
 Ferdi recipes can hook into the [electron webview events](https://electron.atom.io/docs/api/webview-tag/#dom-events) to trigger custom functions.
-- 
cgit v1.2.3-54-g00ecf