> ## Documentation Index > Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. > Auth0 Dashboard と Management API を使用して Organizations を作成する方法について説明します。 # Organizations を作成する export const AuthCodeGroup = ({children, dropdown}) => { const [processedChildren, setProcessedChildren] = useState(children); useEffect(() => { let unsubscribe = null; function init() { unsubscribe = window.autorun(() => { const processChildren = node => { if (typeof node === "string") { let processedNode = node; for (const [key, value] of window.rootStore.variableStore.values.entries()) { const escapedKey = key.replaceAll(/[.*+?^${}()|[\]\\]/g, (String.raw)`\$&`); processedNode = processedNode.replaceAll(new RegExp(escapedKey, "g"), value); } return processedNode; } else if (Array.isArray(node)) { return node.map(processChildren); } else if (node && node.props && node.props.children) { return { ...node, props: { ...node.props, children: processChildren(node.props.children) } }; } return node; }; setProcessedChildren(processChildren(children)); }); } if (window.rootStore) { init(); } else { window.addEventListener("adu:storeReady", init); } return () => { window.removeEventListener("adu:storeReady", init); unsubscribe?.(); }; }, [children]); return {processedChildren}; }; export const AuthCodeBlock = ({filename, icon, language, highlight, children}) => { const [displayText, setDisplayText] = useState(children); const [copyText, setCopyText] = useState(children); const wrapperRef = React.useRef(null); useEffect(() => { let unsubscribe = null; function init() { if (!window.autorun || !window.rootStore) { return; } unsubscribe = window.autorun(() => { let processedChildrenForDisplay = children; let processedChildrenForCopy = children; for (const [key, value] of window.rootStore.variableStore.values.entries()) { const escapedKey = key.replaceAll(/[.*+?^${}()|[\]\\]/g, (String.raw)`\$&`); let displayValue = value; if (key === "{yourClientSecret}" && value !== "{yourClientSecret}") { displayValue = value.substring(0, 3) + "*****MASKED*****"; } processedChildrenForDisplay = processedChildrenForDisplay.replaceAll(new RegExp(escapedKey, "g"), displayValue); processedChildrenForCopy = processedChildrenForCopy.replaceAll(new RegExp(escapedKey, "g"), value); } setDisplayText(processedChildrenForDisplay); setCopyText(processedChildrenForCopy); }); } if (window.rootStore) { init(); } else { window.addEventListener("adu:storeReady", init); } return () => { window.removeEventListener("adu:storeReady", init); unsubscribe?.(); }; }, [children]); useEffect(() => { if (!wrapperRef.current) return; const originalWriteText = navigator.clipboard.writeText.bind(navigator.clipboard); let isOverriding = false; const handleClick = e => { const button = e.target.closest('[data-testid="copy-code-button"]'); if (!button || !wrapperRef.current.contains(button)) return; isOverriding = true; navigator.clipboard.writeText = text => { if (isOverriding) { isOverriding = false; navigator.clipboard.writeText = originalWriteText; return originalWriteText(copyText); } return originalWriteText(text); }; setTimeout(() => { if (isOverriding) { isOverriding = false; navigator.clipboard.writeText = originalWriteText; } }, 100); }; const wrapper = wrapperRef.current; wrapper.addEventListener('click', handleClick, true); return () => { wrapper.removeEventListener('click', handleClick, true); if (navigator.clipboard.writeText !== originalWriteText) { navigator.clipboard.writeText = originalWriteText; } }; }, [copyText]); return
{displayText}
; }; [組織](/docs/ja-jp/manage-users/organizations/organizations-overview) は、Auth0 Dashboard または Management API のいずれかで作成できます。 この機能を利用できるかどうかは、ご利用の Auth0 プランまたはカスタム契約によって異なります。詳しくは、[Pricing](https://auth0.com/pricing) をご覧ください。
## Auth0 Dashboard
Auth0 Dashboard で organization を作成するには、次の手順に従います。 1. [Auth0 Dashboard > Organizations](https://manage.auth0.com/#/organizations) に移動します。 2. **Create Organization** を選択します。 3. organization の基本情報を入力し、**Add Organization** を選択します。 | **Field** | **Description** | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | 作成する organization の名前です。これは、エンドユーザーがどの organization からログインするかを識別するために pre-login prompt に入力する名前です。一意の論理識別子で、小文字のアルファベット、数字、アンダースコア (`_`) 、ダッシュ (`-`) を使用できます。数字で始めることもできます。1 文字以上 50 文字以下である必要があります。 | | **Display Name** | 表示用のわかりやすい名前です。 | 4. **Branding** セクションで organization をカスタマイズし、**変更を保存** を選択します。 | **Field** | **Description** | | ------------------------- | ---------------------------------------------- | | **Organization Logo** | 表示するロゴです。推奨される最小解像度は、幅 200 ピクセル、高さ 200 ピクセルです。 | | **Primary Color** | 主要な要素に使用する色です。 | | **Page Background Color** | 背景に使用する色です。 | 5. **メタデータ** セクションで、organization に必要なメタデータのキーと値のペアを追加し、**Add** を選択します。
## Management API
Management API を使用して organization を作成するには: `Create Organizations` エンドポイントに `POST` リクエストを送信します。プレースホルダー値は テナント の適切な値に置き換えてください。詳細については、以下のパラメータ一覧を参照してください。 ```bash cURL theme={null} curl --request POST \ --url 'https://{yourDomain}/api/v2/organizations' \ --header 'authorization: Bearer {MGMT_API_ACCESS_TOKEN}' \ --header 'cache-control: no-cache' \ --header 'content-type: application/json' \ --data '{ "name": "ORG_NAME", "display_name": "ORG_DISPLAY_NAME", "branding": [ { "logo_url": "{orgLogo}", "colors": [ { "primary": "{orgPrimaryColor}", "page_background": "{orgPageBackground}" } ] } ], "metadata": [ { "{key}": "{value}", "{key}": "{value}", "{key}": "{value}" } ] }, "enabled_connections": [ { "connection_id": "{connectionId}", "assign_membership_on_login": "{assignMembershipOption}" }, { "connection_id": "{connectionId}", "assign_membership_on_login": "{assignMembershipOption}" } ] }' ``` ```csharp C# theme={null} var client = new RestClient("https://{yourDomain}/api/v2/organizations"); var request = new RestRequest(Method.POST); request.AddHeader("content-type", "application/json"); request.AddHeader("authorization", "Bearer {MGMT_API_ACCESS_TOKEN}"); request.AddHeader("cache-control", "no-cache"); request.AddParameter("application/json", "{ "name": "ORG_NAME", "display_name": "ORG_DISPLAY_NAME", "branding": [ { "logo_url": "{orgLogo}", "colors": [ { "primary": "{orgPrimaryColor}", "page_background": "{orgPageBackground}" } ] } ], "metadata": [ { "{key}": "{value}", "{key}": "{value}", "{key}": "{value}" } ] }, "enabled_connections": [ { "connection_id": "{connectionId}", "assign_membership_on_login": "{assignMembershipOption}" }, { "connection_id": "{connectionId}", "assign_membership_on_login": "{assignMembershipOption}" } ] }", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```go Go theme={null} package main import ( "fmt" "strings" "net/http" "io/ioutil" ) func main() { url := "https://{yourDomain}/api/v2/organizations" payload := strings.NewReader("{ "name": "ORG_NAME", "display_name": "ORG_DISPLAY_NAME", "branding": [ { "logo_url": "{orgLogo}", "colors": [ { "primary": "{orgPrimaryColor}", "page_background": "{orgPageBackground}" } ] } ], "metadata": [ { "{key}": "{value}", "{key}": "{value}", "{key}": "{value}" } ] }, "enabled_connections": [ { "connection_id": "{connectionId}", "assign_membership_on_login": "{assignMembershipOption}" }, { "connection_id": "{connectionId}", "assign_membership_on_login": "{assignMembershipOption}" } ] }") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("content-type", "application/json") req.Header.Add("authorization", "Bearer {MGMT_API_ACCESS_TOKEN}") req.Header.Add("cache-control", "no-cache") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := ioutil.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```java Java theme={null} HttpResponse response = Unirest.post("https://{yourDomain}/api/v2/organizations") .header("content-type", "application/json") .header("authorization", "Bearer {MGMT_API_ACCESS_TOKEN}") .header("cache-control", "no-cache") .body("{ "name": "ORG_NAME", "display_name": "ORG_DISPLAY_NAME", "branding": [ { "logo_url": "{orgLogo}", "colors": [ { "primary": "{orgPrimaryColor}", "page_background": "{orgPageBackground}" } ] } ], "metadata": [ { "{key}": "{value}", "{key}": "{value}", "{key}": "{value}" } ] }, "enabled_connections": [ { "connection_id": "{connectionId}", "assign_membership_on_login": "{assignMembershipOption}" }, { "connection_id": "{connectionId}", "assign_membership_on_login": "{assignMembershipOption}" } ] }") .asString(); ``` ```javascript Node.JS theme={null} var axios = require("axios").default; var options = { method: 'POST', url: 'https://{yourDomain}/api/v2/organizations', headers: { 'content-type': 'application/json', authorization: 'Bearer {MGMT_API_ACCESS_TOKEN}', 'cache-control': 'no-cache' }, data: '{ "name": "ORG_NAME", "display_name": "ORG_DISPLAY_NAME", "branding": [ { "logo_url": "{orgLogo}", "colors": [ { "primary": "{orgPrimaryColor}", "page_background": "{orgPageBackground}" } ] } ], "metadata": [ { "{key}": "{value}", "{key}": "{value}", "{key}": "{value}" } ] }, "enabled_connections": [ { "connection_id": "{connectionId}", "assign_membership_on_login": "{assignMembershipOption}" }, { "connection_id": "{connectionId}", "assign_membership_on_login": "{assignMembershipOption}" } ] }' }; axios.request(options).then(function (response) { console.log(response.data); }).catch(function (error) { console.error(error); }); ``` ```php PHP theme={null} $curl = curl_init(); curl_setopt_array($curl, [ CURLOPT_URL => "https://{yourDomain}/api/v2/organizations", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_POSTFIELDS => "{ "name": "ORG_NAME", "display_name": "ORG_DISPLAY_NAME", "branding": [ { "logo_url": "{orgLogo}", "colors": [ { "primary": "{orgPrimaryColor}", "page_background": "{orgPageBackground}" } ] } ], "metadata": [ { "{key}": "{value}", "{key}": "{value}", "{key}": "{value}" } ] }, "enabled_connections": [ { "connection_id": "{connectionId}", "assign_membership_on_login": "{assignMembershipOption}" }, { "connection_id": "{connectionId}", "assign_membership_on_login": "{assignMembershipOption}" } ] }", CURLOPT_HTTPHEADER => [ "authorization: Bearer {MGMT_API_ACCESS_TOKEN}", "cache-control: no-cache", "content-type: application/json" ], ]); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; } ``` ```python Python theme={null} import http.client conn = http.client.HTTPSConnection("") payload = "{ "name": "ORG_NAME", "display_name": "ORG_DISPLAY_NAME", "branding": [ { "logo_url": "{orgLogo}", "colors": [ { "primary": "{orgPrimaryColor}", "page_background": "{orgPageBackground}" } ] } ], "metadata": [ { "{key}": "{value}", "{key}": "{value}", "{key}": "{value}" } ] }, "enabled_connections": [ { "connection_id": "{connectionId}", "assign_membership_on_login": "{assignMembershipOption}" }, { "connection_id": "{connectionId}", "assign_membership_on_login": "{assignMembershipOption}" } ] }" headers = { 'content-type': "application/json", 'authorization': "Bearer {MGMT_API_ACCESS_TOKEN}", 'cache-control': "no-cache" } conn.request("POST", "/{yourDomain}/api/v2/organizations", payload, headers) res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```ruby Ruby theme={null} require 'uri' require 'net/http' require 'openssl' url = URI("https://{yourDomain}/api/v2/organizations") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_PEER request = Net::HTTP::Post.new(url) request["content-type"] = 'application/json' request["authorization"] = 'Bearer {MGMT_API_ACCESS_TOKEN}' request["cache-control"] = 'no-cache' request.body = "{ "name": "ORG_NAME", "display_name": "ORG_DISPLAY_NAME", "branding": [ { "logo_url": "{orgLogo}", "colors": [ { "primary": "{orgPrimaryColor}", "page_background": "{orgPageBackground}" } ] } ], "metadata": [ { "{key}": "{value}", "{key}": "{value}", "{key}": "{value}" } ] }, "enabled_connections": [ { "connection_id": "{connectionId}", "assign_membership_on_login": "{assignMembershipOption}" }, { "connection_id": "{connectionId}", "assign_membership_on_login": "{assignMembershipOption}" } ] }" response = http.request(request) puts response.read_body ``` **Auth0ドメインを確認する** Auth0ドメインは、テナント名、リージョンサブドメイン (テナントが US リージョンにあり、2020 年 6 月より前に作成されている場合を除く) 、および `.auth0.com` を組み合わせたものです。たとえば、テナント名が `travel0` の場合、Auth0ドメイン名は `travel0.us.auth0.com` になります。 (テナントが US にあり、2020 年 6 月より前に作成されている場合、ドメイン名は `https://travel0.auth0.com` になります。) カスタムドメインを使用している場合は、ここにはそのカスタムドメイン名を指定します。 | **値** | **説明** | | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `MGMT_API_ACCESS_TOKEN` | スコープ `create:organizations` を持つ [Access Token for the Management API](/docs/ja-jp/secure/tokens/access-tokens/management-api-access-tokens)。 | | `ORG_NAME` | 作成する organization の名前。これは、エンドユーザーが pre-login prompt で、どの organization を通じてログインするかを識別するために入力する名前です。一意の論理識別子です。使用できるのは、小文字のアルファベット、数字、アンダースコア (`_`) 、ダッシュ (`-`) です。数字で始めることもできます。1 文字以上 50 文字以下である必要があります。 | | `ORG_DISPLAY_NAME` | 任意。ログインフローやメールテンプレートに表示できる、organization のわかりやすい名前です。 | | `ORG_LOGO` | 任意。organization のロゴの URL。 | | `ORG_PRIMARY_COLOR` | 任意。主要な要素に使用する HEX カラーコード。 | | `ORG_BACKGROUND_COLOR` | 任意。背景の HEX カラーコード。 | | `KEY`/`VALUE` | 任意。organization のメタデータを表す String のキーと値のペア。各項目は最大 255 文字です。メタデータのペアは最大 25 個までです。 | | `CONNECTION_ID` | 任意。指定した organization で有効にする接続の ID。有効化された接続は organization の login prompt に表示されるため、ユーザーはそれらを通じてアプリケーションにアクセスできます。 | | `ASSIGN_MEMBERSHIP_OPTION` | 任意。有効化された接続でログインしたユーザーに、指定した organization のメンバーシップを自動的に付与するかどうかを示します。`true` に設定すると、ユーザーには自動的にメンバーシップが付与されます。`false` に設定すると、自動的には付与されません。 |
### レスポンスステータスコード
レスポンスで返される可能性のあるステータスコードは次のとおりです。 | **ステータスコード** | **エラーコード** | **メッセージ** | **原因** | | ------------ | ----------------------- | ------------------------------------------------------------------------------------ | -------------------------------------------------------- | | `201` | | 組織が正常に作成されました。 | | | `400` | `invalid_body` | 無効なリクエスト本文です。メッセージは原因に応じて異なります。 | リクエスト本文の payload が無効です。 | | `400` | `invalid_query_string` | 無効なリクエストクエリ文字列です。メッセージは原因に応じて異なります。 | クエリ文字列が無効です。 | | `401` | | 無効なトークンです。 | | | `401` | | JSON Web トークンのバリデーションで無効な署名を受信しました。 | | | `401` | | クライアントはグローバルではありません。 | | | `403` | `insufficient_scope` | scope が不足しています。必要な scope のいずれか: `create:organizations`。 | 指定されたベアラートークンの scopes では許可されていないフィールドの読み取りまたは書き込みを試みました。 | | `409` | `organization_conflict` | 同じ名前の organization がすでに存在します。 | 同じ名前の organization がすでに存在します。 | | `429` | | リクエストが多すぎます。X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset ヘッダーを確認してください。 | |