Skip to content

Commit 788c880

Browse files
authored
Merge pull request #250 from IgniteUI/vNext
Promote to production
2 parents d0b49e4 + c47218c commit 788c880

File tree

5 files changed

+233
-5
lines changed

5 files changed

+233
-5
lines changed

jp/on-prem-prerequisites-and-installation.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -112,8 +112,12 @@ docker run --restart always -p 80:5000 -e "ConnectionStrings:Provider=SqlServer"
112112

113113
> 注: Docker Desktop を使用している場合は、Containers/Apps に移動し、コンテナーを見つけ、[Open in browser] をクリックします。
114114
115-
<img class="box-shadow> src="./images/docker-apps.png" />
116-
<p style="margin-top:-20px;text-align:center;">Docker の Containers/Apps</p>
115+
<img class="box-shadow" src="./images/docker-apps.png" />
116+
<p style="margin-top:-20px;text-align:center;">Docker Containers/Apps</p>
117+
118+
### OpenID Connect (OAuth 2.0) による認証
119+
120+
詳細については、[OpenID Connect (OAuth 2.0) を使用したオンプレミス認証](on-premises/auth-with-openid-connect-o-auth.md)のトピックを参照してください。
117121

118122
### 更新
119123

@@ -164,6 +168,9 @@ docker rm appbuilder
164168
## その他のリソース
165169
<div class="divider--half"></div>
166170

171+
* [OpenID Connect を使用したオンプレミス認証](on-premises/auth-with-openid-connect-o-auth.md)
172+
* [App Builder 配置構成フラグ](on-premises/configuration-flags.md)
173+
* [外部リソースのホワイトリスト化](on-premises/external-references-for-whitelisting.md)
167174
* [App Builder インターフェイスの概要 ](interface-overview.md)
168175
* [単一ページアプリとナビゲーション](single-page-apps-and-navigation.md)
169176
* [App Builder コンポーネント](indigo-design-app-builder-components.md)
Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
# OpenID Connect (OAuth 2.0) を使用したオンプレミス認証
2+
3+
このドキュメントは、PKCE (Proof Key for Code Exchange) を使用した OAuth 2.0 CODE 認証フローをサポートする OpenID Connect サーバーを使用して、App Builder オンプレミス インスタンスのカスタム認証プロバイダーを構成する方法を説明します。
4+
5+
ガイドの内容:
6+
7+
- 必要な OIDC クライアント設定。
8+
- App Builder 固有の構成設定。
9+
- oidc_scope や oidc_redirect_uri などの追加オプション。
10+
11+
## OIDC クライアントの設定
12+
13+
- OAuth2 フロー: 認証コード + PKCE
14+
- トークンの更新を有効にする (`offline_access` スコープ)
15+
- アクセス トークンの有効期限: (推奨 600 秒)
16+
- 更新トークンの有効期限: スライディング ウィンドウが推奨され、最小 1 時間 (24 時間を推奨)、最大有効期間は組織によって決定され、無制限になります。
17+
- ID トークンにユーザークレームを含めます (必須の標準クレーム: "sub" と "email"、オプションのカスタム クレーム: "given_name" と "family_name")。
18+
- 必要なスコープ: openid email profile offline_access appbuilder.user
19+
- Audience: "appbuilder" (デフォルト)
20+
- サインイン リダイレクト URI: <app builder host>/oidc/ig/callback
21+
- ログアウト後の URL: <app builder host>/oidc/ig/callback-postlogout
22+
23+
## App Builder の設定
24+
25+
### 必要な構成設定
26+
- AuthSettings__SkipAuth: false
27+
- AuthSettings__Authority: _OpenId server URL_
28+
- AuthSettings__ClientId: _OpenId Client Id_
29+
- AuthSettings__AccountIssuer: _Server Unique Alias_
30+
31+
### その他のオプション
32+
- oidc_scope: 'openid email offline_access profile appbuilder.user' (デフォルト)
33+
- oidc_redirect_uri: '/oidc/ig/callback' (デフォルト)
34+
- oidc_post_logout_redirect_uri: /oidc/ig/callback-postlogout' (デフォルト)
35+
- AuthSettings:Audience: "appbuilder" (デフォルト)
36+
37+
> [!NOTE]
38+
> OIDC 認証を使用するには、FrontendOptions_SkipAuth 設定を false に設定する必要があります。
39+
40+
OIDC クライアントを設定したら、次の 3 つの必須プロパティを環境変数として App Builder Docker コンテナーに渡す必要があります。
41+
42+
例:
43+
```sh
44+
docker run --restart always -p 80:5000 -e ConnectionStrings__Provider=SqlServer -e "ConnectionStrings:...." -e AuthSettings__SkipAuth=false -e AuthSettings__Authority="https://my-auth-server.example.com" -e AuthSettings__ClientId="1234-4657-00" -e AuthSettings__AccountIssuer="MyAuth" -v "C:\ProgramData\Infragistics\Appbuilder\logs:/appbuilder/logs" -v "C:\ProgramData\Infragistics\Appbuilder\storage:/appbuilder/storage" --name appbuilder appbuilder:1.0
45+
```
46+
47+
## その他のリソース
48+
<div class="divider--half"></div>
49+
50+
* [オンプレミスの前提条件とインストールの概要](../on-prem-prerequisites-and-installation.md)
51+
* [App Builder の配置構成フラグ](configuration-flags.md)
52+
* [外部リソースのホワイトリスト化](external-references-for-whitelisting.md)
53+
* [Desktop アプリの実行方法](../running-desktop-app.md)
54+
* [アプリを生成する](../generate-app/generate-app-overview.md)
55+
* [Indigo.Design はじめに](https://jp.infragistics.com/products/indigo-design/help/getting-started)
Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
---
2+
title: オンプレミスおよび SDK 配置用の App Builder 構成フラグ
3+
_description: オンプレミスおよびSDKインスタンスの配置フラグを構成する方法について説明します。
4+
_keywords: App builder, On-premises, deployment flags, オンプレミス, 配置フラグ
5+
_language: ja
6+
---
7+
8+
9+
# オンプレミスおよび SDK 配置用の構成フラグ
10+
11+
このドキュメントでは、App Builder オンプレミス インスタンスを配置および管理するために使用できる構成フラグについて説明します。このドキュメントでは、次のような主要な環境変数の例を示す必要があります。
12+
13+
```sh
14+
docker run --restart always -p 80:5000 -e AuthSettings__ClientId="1234-4657-00"
15+
```
16+
17+
## 構成可能なプロパティ
18+
19+
### environment.ts を通じて (App Builder SDK コンテキストの一部)
20+
21+
```
22+
// 構成プロパティの説明:
23+
24+
- favicon: '/favicon_dev.ico', // 独自のファビコンを設定できるようにします
25+
- disableSurvey: false, // App Builder の調査を無効にします
26+
- enableLibrariesManagement: false, // ライブラリ管理のドロップダウンを表示/非表示にします
27+
- disablePublishToGithub: false, // 「GitHub にプッシュ」 ボタンを無効/有効にします
28+
- disableFeedback: false, // フィードバック ダイアログの表示を切り替えます
29+
- showOnboardingVideos: false, // オンボーディングの YouTube ビデオを切り替えます
30+
- toggleableDatasourceTags: false, // データ ソースのカラー タグの表示状態を切り替えます
31+
- hideMainMenu: false, // アプリケーション シェルのメイン メニューの表示状態を切り替えます
32+
- personalWorkspaceLabel: 'myProjects', // 個人ワークスペースのラベル値を設定します
33+
- disableCodegen: false, // コード生成サービスの使用を切り替えます
34+
- hideSharingOptions: false, // UI の共有オプションの表示を切り替えます
35+
- hideHelpResources: false, // インターフェース内のヘルプ リソースを非表示にします
36+
- hideAppBuilderLogo: false, // App Builder のロゴを非表示にします
37+
- disableQuickTips: false, // クイック ヒントを無効にします
38+
- hideMockDataSources: false, // UI からモック データ ソースを非表示にします
39+
- hideVerbPills: false, // API 関連機能の HTTP 動詞ピルを非表示にします
40+
- useSummaryForOperationName: false, // 操作名にはフルネームではなく要約を使用します
41+
- showObjectDatasources: false, // オブジェクトベースのデータ ソースのサポートを有効にします (限定的な使用例)
42+
- hideDesktopApp: false, // UI でデスクトップ アプリ関連のオプションを非表示にします
43+
- hideAccountMenu: false, // UI からアカウント メニューを非表示にします
44+
- hideExperimentalGenerators: [], // コード エクスポートから非表示にするフレームワークを指定します (例: [{ platform: Platform.react }])
45+
- disableMockDataUponFailedEndpoint: false, // エンドポイントにエンドポイントが発生した場合にモック データが使用されないようにします
46+
- disableAI: false, // AI 関連の機能を無効にします
47+
- enableCssGridLayout: true, // CSS グリッド レイアウト機能を有効にします
48+
- showPreviewInvite: true, // コラボレーション機能のプレビュー招待を表示します
49+
50+
// テーマのプロパティ:
51+
52+
appTheme: {
53+
schema: 'light-bootstrap-schema', // 基本テーマのスキーマを定義します
54+
colors: {
55+
primary: '#2D8DFF', // アプリケーション内で使用するプライマリ カラー
56+
secondary: '#2D8DFF', // セカンダリ カラー
57+
surface: '#F1F7FF',
58+
success: '#31AB2B', // 成功インジケーターのカラー
59+
warn: '#F2C200', // 警告インジケーターのカラー
60+
error: '#DB372A', // エラー インジケーターのカラー
61+
info: '#0678FF', // 情報インジケーターのカラー
62+
grays: '#2F2F2F',
63+
},
64+
typeface: 'Public Sans', // アプリケーションのデフォルト フォント
65+
fonts: [], // 追加のフォント ファミリー
66+
scale: 'bootstrap-type-scale',
67+
roundness: 0.3, // 角丸
68+
elevation: null, // 該当する場合、標高 (影)
69+
},
70+
71+
shellTheme: {
72+
typeface: 'Public Sans', // アプリケーション シェルで使用されるフォント
73+
colors: {
74+
primary: '#2D8DFF', // プライマリ カラー
75+
grays: '#9A9DA2',
76+
success: '#31AB2B', // 成功インジケーターのカラー
77+
warn: '#F2C200', // 警告カラー
78+
error: '#DB372A', // エラー カラー
79+
aux1: '#068E6B',
80+
aux2: '#9C27B0',
81+
},
82+
}
83+
```
84+
85+
### docker run コマンドのパラメーターを通じて (オンプレミスのコンテキスト)
86+
87+
```sh
88+
docker run --restart always -p 80:5000 -e AuthSettings__ClientId="1234-4657-00"
89+
```
90+
91+
## その他のリソース
92+
<div class="divider--half"></div>
93+
94+
* [OpenID Connect による認証](auth-with-openid-connect-o-auth.md)
95+
* [外部リソースのホワイトリスト化](external-references-for-whitelisting.md)
96+
* [オンプレミスの前提条件とインストールの概要](../on-prem-prerequisites-and-installation.md)
97+
* [App Builder インターフェイスの概要](../interface-overview.md)
Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
title: App Builder オンプレミスの外部参照のホワイトリスト化
3+
_description: オンプレミス インスタンスのすべての外部リソースをホワイトリストに登録する方法について説明します。
4+
_keywords: App builder, On-premises, whitelisting, オンプレミス, ホワイトリスト化
5+
_language: ja
6+
---
7+
8+
# オンプレミス App Builder の外部リソースのホワイトリスト化
9+
10+
## 概要
11+
このドキュメントでは、オンプレミス環境内で App Builder が適切に機能するためにホワイトリストに登録する必要がある外部 URL について説明します。これらの URL をホワイトリストに登録すると、コンポーネント ライブラリ、ドキュメント、ビデオ チュートリアルなどのリソースへのシームレスなアクセスが保証され、開発とユーザー エクスペリエンスの両方が向上します。
12+
13+
## 実装のヒント:
14+
このホワイトリストを統合することで、開発者はオンプレミスのセットアップから Infragistics App Builder に必要なすべての外部リソースにアクセスできるようになります。
15+
16+
1. ブロックされないように、以下の URL がネットワークのホワイトリストまたはプロキシ設定に追加されていることを確認してください。
17+
2. 新しいリソースや URL が追加された場合、または変更があった場合は、このリストを定期的に更新してください。
18+
3. 複数のサブページが必要になる可能性があるドメインには、ワイルドカード エントリの使用を検討してください (例: すべての Infragistics リソースの場合は *.infragistics.com)。例:
19+
- すべての Infragistics リソースに `*.infragistics.com` を追加します。
20+
- App Builder 固有のリソース用に `*.appbuilder.dev` を追加します。
21+
- 複数のパスが存在する可能性がある YouTube などのサービスの場合、YouTube サイト全体へのアクセスを許可するには `*.youtube.com` を検討してください。
22+
- Discord チャンネルは[一般的な Web URL](https://discord.com/channels/836634487483269200/836635360594755665) ではないため、特定のエントリが必要になる場合があります。
23+
24+
## ホワイトリストのカテゴリ
25+
以下に、App Builder プラットフォームに含まれるすべての外部 URL の詳細なリストを示します。明確さと使いやすさを確保するために、URL はその目的に基づいてカテゴリごとに整理されています。
26+
27+
#### App Builder リソース
28+
- [ランディング ページ。](https://jp.infragistics.com/products/appbuilder)
29+
- [価格ページ。](https://www.appbuilder.dev/ja/pricing)
30+
- [Windows](https://jp.infragistics.com/products/appbuilder/download)[Mac](https://jp.infragistics.com/products/appbuilder/download/mac)[Linux](https://jp.infragistics.com/products/appbuilder/download/linux) 用の App Builder デスクトップ アプリケーション。
31+
- [プレビュー版環境](https://preview.appbuilder.dev/)[製品版環境](https://my.appbuilder.dev/)のプラットフォーム URL。
32+
- [サブスクリプション](https://account.appbuilder.dev/subscriptions)[個人プロファイル](https://account.appbuilder.dev/private-profile)のユーザー アカウント。
33+
34+
#### ドキュメントとヘルプ。
35+
- [作業の開始。](https://jp.infragistics.com/products/appbuilder/help/getting-started)
36+
- [変更ログ。](https://jp.infragistics.com/products/appbuilder/help/change-log)
37+
- [ナビゲーションのヒント。](https://jp.infragistics.com/products/appbuilder/help/single-page-apps-and-navigation)
38+
- [レイアウトのヒント。](https://jp.infragistics.com/products/appbuilder/help/flex-layouts/flex-layouts)
39+
#### 製品ページ
40+
- [Reveal BI のヘルプ ページ。](https://help.revealbi.io/ja/web/getting-started-angular/)
41+
#### 法律 & プライバシー。
42+
- [Infragistics のプライバシー ポリシー。](https://jp.infragistics.com/legal/privacy)
43+
- [Infragistics の利用条件。](https://jp.infragistics.com/legal/terms-of-use)
44+
- [App Builder AI のプライバシー ポリシー。](https://www.appbuilder.dev/ja/ai-privacy-policy)
45+
46+
#### コミュニティ & サポート
47+
- [Discord](https://discord.com/channels/836634487483269200/836635360594755665)
48+
- [ウェビナーや作業の開始コンテンツを含む YouTube ビデオ。](https://www.youtube.com/@AppBuilder_Dev)
49+
#### コンポーネント ライブラリ
50+
- [Ignite UI for Angular](https://jp.infragistics.com/products/ignite-ui-angular/angular)
51+
- [Ignite UI for Blazor](https://jp.infragistics.com/products/ignite-ui-blazor/blazor)
52+
- [Ignite UI for Web Components](https://jp.infragistics.com/products/ignite-ui-web-components/web-components)
53+
- [Ignite UI for React](https://jp.infragistics.com/products/ignite-ui-react/react)
54+
55+
56+
このトピックの推奨事項に従うことで、ユーザーは必要なリソースに簡単にアクセスできるようになり、ネットワーク セキュリティを維持しながらワークフローの摩擦を軽減できます。
57+
58+
## その他の App Builder リソース
59+
<div class="divider--half"></div>
60+
61+
* [OpenID Connect を使用したオンプレミス認証](auth-with-openid-connect-o-auth.md)
62+
* [App Builder の配置構成フラグ](configuration-flags.md)

jp/sidebar-toc/toc.yml

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,16 @@
99
items:
1010
- name: オンプレミスの前提条件とインストール
1111
href: ../on-prem-prerequisites-and-installation.md
12+
updated: true
13+
- name: OpenID Connect による認証
14+
href: ../on-premises/auth-with-openid-connect-o-auth.md
15+
new: true
16+
- name: オンプレミスと SDK の構成フラグ
17+
href: ../on-premises/configuration-flags.md
18+
new: true
19+
- name: オンプレミス App Builder の外部リソースのホワイトリスト化
20+
href: ../on-premises/external-references-for-whitelisting.md
21+
new: true
1222
- name: Desktop アプリの実行方法
1323
href: ../running-desktop-app.md
1424
- name: アプリケーションの共有、プレビュー、および編集
@@ -21,9 +31,6 @@
2131
- name: Figma
2232
href: ../ui-kits/figma.md
2333
new: false
24-
# - name: Adobe XD
25-
# href: ../ui-kits/adobe-xd.md
26-
# new: false
2734
- name: Sketch
2835
href: ../ui-kits/sketch.md
2936
new: false

0 commit comments

Comments
 (0)