在 AngularJS 中動態指定 iframe 來源時,如果網址跨了網域,畫面會一片空白,主控台則跳出類似下面的錯誤:
Blocked loading resource from url not allowed by $sceDelegate policy
這不是 iframe 本身的限制,而是 AngularJS 的 SCE(Strict Contextual Escaping,嚴格情境轉義)機制在把關。Angular 預設不信任任何動態插入的外部資源網址,因此當你用插值把變數塞進 ng-src 時,框架會先檢查該網址是否在白名單中;不在名單內就直接攔下並拋出 $sceDelegate 相關錯誤。
出錯的模板大概長這樣:
<iframe id="myFrame" ng-src="{{url}}" width="100%" height="100%"
seamless frameborder="0"></iframe>
告訴 Angular 哪些網址是可以信任的即可:
app.config(function($sceDelegateProvider) {
$sceDelegateProvider.resourceUrlWhitelist([
// Allow same origin resource loads.
'self',
// Allow loading from our assets domain.
// Notice the difference between * and **.
'https://media.w3.org/**'
]);
});
幾個細節值得注意:
'self' 代表允許同源資源,建議永遠保留。* 與 ** 的通配範圍不同:前者只匹配單一層路徑片段,後者能匹配多層。寫白名單時要特別小心,範圍開太大等於放寬安全邊界。https://,協定必須完全對應。SCE 存在的目的,是防止未經檢查的內容被當成 HTML、URL 或 JS 執行,降低 XSS 風險。關掉或放寬白名單前,請先確認幾件事:
** 一次放行整個網域。X-Frame-Options 或 CSP 的 frame-ancestors 拒絕被嵌入。這種情況即使 Angular 這邊放行,瀏覽器仍會阻擋,需要改由後端代理或改開新視窗。$sce.trustAsResourceUrl(url) 在指派前明確標記信任,讓意圖更清楚。設定好白名單後,AngularJS 跨域使用 iframe 的問題即可排除。