Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[JA] New topics (On-Prem) #249

Merged
merged 3 commits into from
Jan 6, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 9 additions & 2 deletions jp/on-prem-prerequisites-and-installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -112,8 +112,12 @@ docker run --restart always -p 80:5000 -e "ConnectionStrings:Provider=SqlServer"

> 注: Docker Desktop を使用している場合は、Containers/Apps に移動し、コンテナーを見つけ、[Open in browser] をクリックします。

<img class="box-shadow> src="./images/docker-apps.png" />
<p style="margin-top:-20px;text-align:center;">Docker の Containers/Apps</p>
<img class="box-shadow" src="./images/docker-apps.png" />
<p style="margin-top:-20px;text-align:center;">Docker Containers/Apps</p>

### OpenID Connect (OAuth 2.0) による認証

詳細については、[OpenID Connect (OAuth 2.0) を使用したオンプレミス認証](on-premises/auth-with-openid-connect-o-auth.md)のトピックを参照してください。

### 更新

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

* [OpenID Connect を使用したオンプレミス認証](on-premises/auth-with-openid-connect-o-auth.md)
* [App Builder 配置構成フラグ](on-premises/configuration-flags.md)
* [外部リソースのホワイトリスト化](on-premises/external-references-for-whitelisting.md)
* [App Builder インターフェイスの概要 ](interface-overview.md)
* [単一ページアプリとナビゲーション](single-page-apps-and-navigation.md)
* [App Builder コンポーネント](indigo-design-app-builder-components.md)
Expand Down
55 changes: 55 additions & 0 deletions jp/on-premises/auth-with-openid-connect-o-auth.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
# OpenID Connect (OAuth 2.0) を使用したオンプレミス認証

このドキュメントは、PKCE (Proof Key for Code Exchange) を使用した OAuth 2.0 CODE 認証フローをサポートする OpenID Connect サーバーを使用して、App Builder オンプレミス インスタンスのカスタム認証プロバイダーを構成する方法を説明します。

ガイドの内容:

- 必要な OIDC クライアント設定。
- App Builder 固有の構成設定。
- oidc_scope や oidc_redirect_uri などの追加オプション。

## OIDC クライアントの設定

- OAuth2 フロー: 認証コード + PKCE
- トークンの更新を有効にする (`offline_access` スコープ)
- アクセス トークンの有効期限: (推奨 600 秒)
- 更新トークンの有効期限: スライディング ウィンドウが推奨され、最小 1 時間 (24 時間を推奨)、最大有効期間は組織によって決定され、無制限になります。
- ID トークンにユーザークレームを含めます (必須の標準クレーム: "sub" と "email"、オプションのカスタム クレーム: "given_name" と "family_name")。
- 必要なスコープ: openid email profile offline_access appbuilder.user
- Audience: "appbuilder" (デフォルト)
- サインイン リダイレクト URI: <app builder host>/oidc/ig/callback
- ログアウト後の URL: <app builder host>/oidc/ig/callback-postlogout

## App Builder の設定

### 必要な構成設定
- AuthSettings__SkipAuth: false
- AuthSettings__Authority: _OpenId server URL_
- AuthSettings__ClientId: _OpenId Client Id_
- AuthSettings__AccountIssuer: _Server Unique Alias_

### その他のオプション
- oidc_scope: 'openid email offline_access profile appbuilder.user' (デフォルト)
- oidc_redirect_uri: '/oidc/ig/callback' (デフォルト)
- oidc_post_logout_redirect_uri: /oidc/ig/callback-postlogout' (デフォルト)
- AuthSettings:Audience: "appbuilder" (デフォルト)

> [!NOTE]
> OIDC 認証を使用するには、FrontendOptions_SkipAuth 設定を false に設定する必要があります。

OIDC クライアントを設定したら、次の 3 つの必須プロパティを環境変数として App Builder Docker コンテナーに渡す必要があります。

例:
```sh
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
```

## その他のリソース
<div class="divider--half"></div>

* [オンプレミスの前提条件とインストールの概要](../on-prem-prerequisites-and-installation.md)
* [App Builder の配置構成フラグ](configuration-flags.md)
* [外部リソースのホワイトリスト化](external-references-for-whitelisting.md)
* [Desktop アプリの実行方法](../running-desktop-app.md)
* [アプリを生成する](../generate-app/generate-app-overview.md)
* [Indigo.Design はじめに](https://jp.infragistics.com/products/indigo-design/help/getting-started)
97 changes: 97 additions & 0 deletions jp/on-premises/configuration-flags.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,97 @@
---
title: オンプレミスおよび SDK 配置用の App Builder 構成フラグ
_description: オンプレミスおよびSDKインスタンスの配置フラグを構成する方法について説明します。
_keywords: App builder, On-premises, deployment flags, オンプレミス, 配置フラグ
_language: ja
---


# オンプレミスおよび SDK 配置用の構成フラグ

このドキュメントでは、App Builder オンプレミス インスタンスを配置および管理するために使用できる構成フラグについて説明します。このドキュメントでは、次のような主要な環境変数の例を示す必要があります。

```sh
docker run --restart always -p 80:5000 -e AuthSettings__ClientId="1234-4657-00"
```

## 構成可能なプロパティ

### environment.ts を通じて (App Builder SDK コンテキストの一部)

```
// 構成プロパティの説明:

- favicon: '/favicon_dev.ico', // 独自のファビコンを設定できるようにします
- disableSurvey: false, // App Builder の調査を無効にします
- enableLibrariesManagement: false, // ライブラリ管理のドロップダウンを表示/非表示にします
- disablePublishToGithub: false, // 「GitHub にプッシュ」 ボタンを無効/有効にします
- disableFeedback: false, // フィードバック ダイアログの表示を切り替えます
- showOnboardingVideos: false, // オンボーディングの YouTube ビデオを切り替えます
- toggleableDatasourceTags: false, // データ ソースのカラー タグの表示状態を切り替えます
- hideMainMenu: false, // アプリケーション シェルのメイン メニューの表示状態を切り替えます
- personalWorkspaceLabel: 'myProjects', // 個人ワークスペースのラベル値を設定します
- disableCodegen: false, // コード生成サービスの使用を切り替えます
- hideSharingOptions: false, // UI の共有オプションの表示を切り替えます
- hideHelpResources: false, // インターフェース内のヘルプ リソースを非表示にします
- hideAppBuilderLogo: false, // App Builder のロゴを非表示にします
- disableQuickTips: false, // クイック ヒントを無効にします
- hideMockDataSources: false, // UI からモック データ ソースを非表示にします
- hideVerbPills: false, // API 関連機能の HTTP 動詞ピルを非表示にします
- useSummaryForOperationName: false, // 操作名にはフルネームではなく要約を使用します
- showObjectDatasources: false, // オブジェクトベースのデータ ソースのサポートを有効にします (限定的な使用例)
- hideDesktopApp: false, // UI でデスクトップ アプリ関連のオプションを非表示にします
- hideAccountMenu: false, // UI からアカウント メニューを非表示にします
- hideExperimentalGenerators: [], // コード エクスポートから非表示にするフレームワークを指定します (例: [{ platform: Platform.react }])
- disableMockDataUponFailedEndpoint: false, // エンドポイントにエンドポイントが発生した場合にモック データが使用されないようにします
- disableAI: false, // AI 関連の機能を無効にします
- enableCssGridLayout: true, // CSS グリッド レイアウト機能を有効にします
- showPreviewInvite: true, // コラボレーション機能のプレビュー招待を表示します

// テーマのプロパティ:

appTheme: {
schema: 'light-bootstrap-schema', // 基本テーマのスキーマを定義します
colors: {
primary: '#2D8DFF', // アプリケーション内で使用するプライマリ カラー
secondary: '#2D8DFF', // セカンダリ カラー
surface: '#F1F7FF',
success: '#31AB2B', // 成功インジケーターのカラー
warn: '#F2C200', // 警告インジケーターのカラー
error: '#DB372A', // エラー インジケーターのカラー
info: '#0678FF', // 情報インジケーターのカラー
grays: '#2F2F2F',
},
typeface: 'Public Sans', // アプリケーションのデフォルト フォント
fonts: [], // 追加のフォント ファミリー
scale: 'bootstrap-type-scale',
roundness: 0.3, // 角丸
elevation: null, // 該当する場合、標高 (影)
},

shellTheme: {
typeface: 'Public Sans', // アプリケーション シェルで使用されるフォント
colors: {
primary: '#2D8DFF', // プライマリ カラー
grays: '#9A9DA2',
success: '#31AB2B', // 成功インジケーターのカラー
warn: '#F2C200', // 警告カラー
error: '#DB372A', // エラー カラー
aux1: '#068E6B',
aux2: '#9C27B0',
},
}
```

### docker run コマンドのパラメーターを通じて (オンプレミスのコンテキスト)

```sh
docker run --restart always -p 80:5000 -e AuthSettings__ClientId="1234-4657-00"
```

## その他のリソース
<div class="divider--half"></div>

* [OpenID Connect による認証](auth-with-openid-connect-o-auth.md)
* [外部リソースのホワイトリスト化](external-references-for-whitelisting.md)
* [オンプレミスの前提条件とインストールの概要](../on-prem-prerequisites-and-installation.md)
* [App Builder インターフェイスの概要](../interface-overview.md)
62 changes: 62 additions & 0 deletions jp/on-premises/external-references-for-whitelisting.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
---
title: App Builder オンプレミスの外部参照のホワイトリスト化
_description: オンプレミス インスタンスのすべての外部リソースをホワイトリストに登録する方法について説明します。
_keywords: App builder, On-premises, whitelisting, オンプレミス, ホワイトリスト化
_language: ja
---

# オンプレミス App Builder の外部リソースのホワイトリスト化

## 概要
このドキュメントでは、オンプレミス環境内で App Builder が適切に機能するためにホワイトリストに登録する必要がある外部 URL について説明します。これらの URL をホワイトリストに登録すると、コンポーネント ライブラリ、ドキュメント、ビデオ チュートリアルなどのリソースへのシームレスなアクセスが保証され、開発とユーザー エクスペリエンスの両方が向上します。

## 実装のヒント:
このホワイトリストを統合することで、開発者はオンプレミスのセットアップから Infragistics App Builder に必要なすべての外部リソースにアクセスできるようになります。

1. ブロックされないように、以下の URL がネットワークのホワイトリストまたはプロキシ設定に追加されていることを確認してください。
2. 新しいリソースや URL が追加された場合、または変更があった場合は、このリストを定期的に更新してください。
3. 複数のサブページが必要になる可能性があるドメインには、ワイルドカード エントリの使用を検討してください (例: すべての Infragistics リソースの場合は *.infragistics.com)。例:
- すべての Infragistics リソースに `*.infragistics.com` を追加します。
- App Builder 固有のリソース用に `*.appbuilder.dev` を追加します。
- 複数のパスが存在する可能性がある YouTube などのサービスの場合、YouTube サイト全体へのアクセスを許可するには `*.youtube.com` を検討してください。
- Discord チャンネルは[一般的な Web URL](https://discord.com/channels/836634487483269200/836635360594755665) ではないため、特定のエントリが必要になる場合があります。

## ホワイトリストのカテゴリ
以下に、App Builder プラットフォームに含まれるすべての外部 URL の詳細なリストを示します。明確さと使いやすさを確保するために、URL はその目的に基づいてカテゴリごとに整理されています。

#### App Builder リソース
- [ランディング ページ。](https://jp.infragistics.com/products/appbuilder)
- [価格ページ。](https://www.appbuilder.dev/ja/pricing)
- [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 デスクトップ アプリケーション。
- [プレビュー版環境](https://preview.appbuilder.dev/)と[製品版環境](https://my.appbuilder.dev/)のプラットフォーム URL。
- [サブスクリプション](https://account.appbuilder.dev/subscriptions)と[個人プロファイル](https://account.appbuilder.dev/private-profile)のユーザー アカウント。

#### ドキュメントとヘルプ。
- [作業の開始。](https://jp.infragistics.com/products/appbuilder/help/getting-started)
- [変更ログ。](https://jp.infragistics.com/products/appbuilder/help/change-log)
- [ナビゲーションのヒント。](https://jp.infragistics.com/products/appbuilder/help/single-page-apps-and-navigation)
- [レイアウトのヒント。](https://jp.infragistics.com/products/appbuilder/help/flex-layouts/flex-layouts)
#### 製品ページ
- [Reveal BI のヘルプ ページ。](https://help.revealbi.io/ja/web/getting-started-angular/)
#### 法律 & プライバシー。
- [Infragistics のプライバシー ポリシー。](https://jp.infragistics.com/legal/privacy)
- [Infragistics の利用条件。](https://jp.infragistics.com/legal/terms-of-use)
- [App Builder AI のプライバシー ポリシー。](https://www.appbuilder.dev/ja/ai-privacy-policy)

#### コミュニティ & サポート
- [Discord](https://discord.com/channels/836634487483269200/836635360594755665)
- [ウェビナーや作業の開始コンテンツを含む YouTube ビデオ。](https://www.youtube.com/@AppBuilder_Dev)
#### コンポーネント ライブラリ
- [Ignite UI for Angular](https://jp.infragistics.com/products/ignite-ui-angular/angular)
- [Ignite UI for Blazor](https://jp.infragistics.com/products/ignite-ui-blazor/blazor)
- [Ignite UI for Web Components](https://jp.infragistics.com/products/ignite-ui-web-components/web-components)
- [Ignite UI for React](https://jp.infragistics.com/products/ignite-ui-react/react)


このトピックの推奨事項に従うことで、ユーザーは必要なリソースに簡単にアクセスできるようになり、ネットワーク セキュリティを維持しながらワークフローの摩擦を軽減できます。

## その他の App Builder リソース
<div class="divider--half"></div>

* [OpenID Connect を使用したオンプレミス認証](auth-with-openid-connect-o-auth.md)
* [App Builder の配置構成フラグ](configuration-flags.md)
13 changes: 10 additions & 3 deletions jp/sidebar-toc/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,16 @@
items:
- name: オンプレミスの前提条件とインストール
href: ../on-prem-prerequisites-and-installation.md
updated: true
- name: OpenID Connect による認証
href: ../on-premises/auth-with-openid-connect-o-auth.md
new: true
- name: オンプレミスと SDK の構成フラグ
href: ../on-premises/configuration-flags.md
new: true
- name: オンプレミス App Builder の外部リソースのホワイトリスト化
href: ../on-premises/external-references-for-whitelisting.md
new: true
- name: Desktop アプリの実行方法
href: ../running-desktop-app.md
- name: アプリケーションの共有、プレビュー、および編集
Expand All @@ -21,9 +31,6 @@
- name: Figma
href: ../ui-kits/figma.md
new: false
# - name: Adobe XD
# href: ../ui-kits/adobe-xd.md
# new: false
- name: Sketch
href: ../ui-kits/sketch.md
new: false
Expand Down
Loading