Oracle Cloud Infrastructure Compute ClassicのREST API

セキュリティ・アプリケーションの作成

post

/secapplication/

セキュリティ・アプリケーションを作成します。セキュリティ・アプリケーションの作成後、これらをセキュリティ・ルールで使用するには、HTTPリクエストのPOST /secrule/ (セキュリティ・ルールの作成)を使用します。

必要なロール: このタスクを実行するには、Compute_Operationsのロールが必要です。このロールが割り当てられていない、または割当てが不明な場合は、システム管理者に連絡してロールがユーザーにOracle Cloud My Servicesで割り当てられるようにしてください。 Oracle Cloudの管理および監視のユーザー・ロールの変更に関する項を参照してください。

リクエスト

サポートされるメディア・タイプ

application/oracle-compute-v3+json

ヘッダー・パラメータ

Cookie: string

Cookie:ヘッダーは、サービスに対するすべてのリクエストに含まれる必要があります。それをPOST /authenticate/コールに対して受信されたレスポンス内のset-cookieヘッダーの値に設定してください。

リクエスト本文には、作成するセキュリティ・アプリケーションの詳細が含まれます。

ルート・スキーマ : SecApplication-post-request

型: object

リクエスト本文には、作成するセキュリティ・アプリケーションの詳細が含まれます。

ソースの表示

description(optional): string

セキュリティ・アプリケーションの説明。
dport(optional): string

TCPまたはUDP宛先ポート番号。
TCPの5900-5999など、ポート範囲も指定できます。
tcpまたはudpをプロトコルとして指定する場合、dportパラメータは必須となりますが、それ以外の場合はオプションです。
このパラメータは、icmpプロトコルには関連しません。
注意: 範囲の終了が範囲の開始よりも低い場合、このリクエストは失敗します。たとえば、5000-4000のポート範囲を指定する場合です。
icmpcode(optional): string
ICMPコード。
このパラメータは、icmpをプロトコルとして指定する場合にのみ関連します。次の値のいずれか1つを指定できます。
- network
- host
- protocol
- port
- df
- admin
icmpをプロトコルとして指定するが、icmptypeまたはicmpcodeを指定しない場合は、すべてのICMPパケットが一致します。
icmptype(optional): string
ICMPタイプ。
このパラメータは、icmpをプロトコルとして指定する場合にのみ関連します。次の値のいずれか1つを指定できます。
- echo
- reply
- ttl
- traceroute
- unreachable
icmpをプロトコルとして指定するが、icmptypeまたはicmpcodeを指定しない場合は、すべてのICMPパケットが一致します。
name: string

オブジェクトの、3つの部分からなる名前(/Compute-identity_domain/user/object)。
オブジェクト名には、英数字、アンダースコア(_)およびハイフン(-)のみを含めることができます。オブジェクト名は大文字と小文字が区別されます。
protocol: string

使用するプロトコル。
指定する値は、プロトコルのテキスト表現か、任意の符号なし8ビット割当てプロトコル番号(0-254の範囲)のいずれかになります。「割当済インターネット・プロトコル番号」を参照してください。
たとえば、tcpまたは番号6のいずれかを指定できます。
次のテキスト表現を使用できます。tcp、udp、icmp、igmp、ipip、rdp、esp、ah、gre、icmpv6、ospf、pim、sctp、mplsip、all。
すべてのプロトコルを指定するには、これをallに設定します。

{
    "required":[
        "name",
        "protocol"
    ],
    "description":"The request body contains details of the security application that you want to create. ",
    "properties":{
        "description":{
            "type":"string",
            "description":"<p>A description of the security application."
        },
        "dport":{
            "type":"string",
            "description":"<p>The TCP or UDP destination port number.<p>You can also specify a port range, such as 5900-5999 for TCP.<p>If you specify <code>tcp</code> or <code>udp</code> as the protocol, then the <code>dport</code> parameter is required; otherwise, it is optional.<p>This parameter isn't relevant to the <code>icmp</code> protocol.<p><b>Note:</b> This request fails if the range-end is lower than the range-start. For example, if you specify the port range as 5000-4000."
        },
        "icmpcode":{
            "type":"string",
            "description":"The ICMP code.<p>This parameter is relevant only if you specify <code>icmp</code> as the protocol. You can specify one of the following values:<ul><li><code>network</code></li><li><code>host</code></li><li><code>protocol</code></li><li><code>port</code></li><li><code>df</code></li><li><code>admin</code></li></ul><p>If you specify <code>icmp</code> as the protocol and don't specify <code>icmptype</code> or <code>icmpcode</code>, then all ICMP packets are matched."
        },
        "icmptype":{
            "type":"string",
            "description":"The ICMP type.<p>This parameter is relevant only if you specify <code>icmp</code> as the protocol. You can specify one of the following values:<ul><li><code>echo</code></li><li><code>reply</code></li><li><code>ttl</code></li><li><code>traceroute</code></li><li><code>unreachable</code></li></ul><p>If you specify <code>icmp</code> as the protocol and don't specify <code>icmptype</code> or <code>icmpcode</code>, then all ICMP packets are matched."
        },
        "name":{
            "type":"string",
            "description":"<p>The three-part name of the object (<code>/Compute-<em>identity_domain</em>/<em>user</em>/<em>object</em></code>).<p>Object names can contain only alphanumeric characters, hyphens, underscores, and periods. Object names are case-sensitive."
        },
        "protocol":{
            "type":"string",
            "description":"The protocol to use.<p>The value that you specify can be either a text representation of a protocol or any unsigned 8-bit assigned protocol number in the range 0-254. See <a target=\"_blank\" href=\"http://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml\">Assigned Internet Protocol Numbers</a>.<p>For example, you can specify either tcp or the number 6.<p>The following text representations are allowed: <code>tcp</code>, <code>udp</code>, <code>icmp</code>, <code>igmp</code>, <code>ipip</code>, <code>rdp</code>, <code>esp</code>, <code>ah</code>, <code>gre</code>, <code>icmpv6</code>, <code>ospf</code>, <code>pim</code>, <code>sctp</code>, <code>mplsip</code>, <code>all</code>.<p>To specify all protocols, set this to <code>all</code>."
        }
    }
}

トップに戻る

レスポンス

サポートされるメディア・タイプ

application/oracle-compute-v3+json

201レスポンス

作成されました。返される可能性のあるその他のHTTPステータス・コードの詳細は、「ステータス・コード」を参照してください。

ヘッダー

set-cookie: string

セッションが拡張された場合、Cookie値が返されます。

ルート・スキーマ : SecApplication-response

型: object

ソースの表示

description(optional): string

セキュリティ・アプリケーションの説明。
dport(optional): string

TCPまたはUDP宛先ポート番号。
TCPの5900-5999など、ポート範囲も指定できます。
tcpまたはudpをプロトコルとして指定する場合、dportパラメータは必須となりますが、それ以外の場合はオプションです。
このパラメータは、icmpプロトコルには関連しません。
注意: 範囲の終了が範囲の開始よりも低い場合、このリクエストは失敗します。たとえば、5000-4000のポート範囲を指定する場合です。
icmpcode(optional): string
ICMPコード。
このパラメータは、icmpをプロトコルとして指定する場合にのみ関連します。次の値のいずれか1つを指定できます。
- network
- host
- protocol
- port
- df
- admin
icmpをプロトコルとして指定するが、icmptypeまたはicmpcodeを指定しない場合は、すべてのICMPパケットが一致します。
icmptype(optional): string
ICMPタイプ。
このパラメータは、icmpをプロトコルとして指定する場合にのみ関連します。次の値のいずれか1つを指定できます。
- echo
- reply
- ttl
- traceroute
- unreachable
icmpをプロトコルとして指定するが、icmptypeまたはicmpcodeを指定しない場合は、すべてのICMPパケットが一致します。
name(optional): string

オブジェクトの、3つの部分からなる名前(/Compute-identity_domain/user/object)。
protocol(optional): string

使用するプロトコル。
指定する値は、プロトコルのテキスト表現か、任意の符号なし8ビット割当てプロトコル番号(0-254の範囲)のいずれかになります。「割当済インターネット・プロトコル番号」を参照してください。
たとえば、tcpまたは番号6のいずれかを指定できます。
次のテキスト表現を使用できます。tcp、udp、icmp、igmp、ipip、rdp、esp、ah、gre、icmpv6、ospf、pim、sctp、mplsip、all。
すべてのプロトコルを指定するには、これをallに設定します。
uri(optional): string

Uniform Resource Identifier

{
    "properties":{
        "description":{
            "type":"string",
            "description":"<p>A description of the security application."
        },
        "dport":{
            "type":"string",
            "description":"<p>The TCP or UDP destination port number.<p>You can also specify a port range, such as 5900-5999 for TCP.<p>If you specify <code>tcp</code> or <code>udp</code> as the protocol, then the <code>dport</code> parameter is required; otherwise, it is optional.<p>This parameter isn't relevant to the <code>icmp</code> protocol.<p><b>Note:</b> This request fails if the range-end is lower than the range-start. For example, if you specify the port range as 5000-4000."
        },
        "icmpcode":{
            "type":"string",
            "description":"The ICMP code.<p>This parameter is relevant only if you specify <code>icmp</code> as the protocol. You can specify one of the following values:<ul><li><code>network</code></li><li><code>host</code></li><li><code>protocol</code></li><li><code>port</code></li><li><code>df</code></li><li><code>admin</code></li></ul><p>If you specify <code>icmp</code> as the protocol and don't specify <code>icmptype</code> or <code>icmpcode</code>, then all ICMP packets are matched."
        },
        "icmptype":{
            "type":"string",
            "description":"The ICMP type.<p>This parameter is relevant only if you specify <code>icmp</code> as the protocol. You can specify one of the following values:<ul><li><code>echo</code></li><li><code>reply</code></li><li><code>ttl</code></li><li><code>traceroute</code></li><li><code>unreachable</code></li></ul><p>If you specify <code>icmp</code> as the protocol and don't specify <code>icmptype</code> or <code>icmpcode</code>, then all ICMP packets are matched."
        },
        "name":{
            "type":"string",
            "description":"The three-part name of the object (<code>/Compute-<em>identity_domain</em>/<em>user</em>/<em>object</em></code>)."
        },
        "protocol":{
            "type":"string",
            "description":"The protocol to use.<p>The value that you specify can be either a text representation of a protocol or any unsigned 8-bit assigned protocol number in the range 0-254. See <a target=\"_blank\" href=\"http://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml\">Assigned Internet Protocol Numbers</a>.<p>For example, you can specify either tcp or the number 6.<p>The following text representations are allowed: <code>tcp</code>, <code>udp</code>, <code>icmp</code>, <code>igmp</code>, <code>ipip</code>, <code>rdp</code>, <code>esp</code>, <code>ah</code>, <code>gre</code>, <code>icmpv6</code>, <code>ospf</code>, <code>pim</code>, <code>sctp</code>, <code>mplsip</code>, <code>all</code>.<p>To specify all protocols, set this to <code>all</code>."
        },
        "uri":{
            "type":"string",
            "description":"Uniform Resource Identifier"
        }
    }
}

トップに戻る

例

cURLコマンド

次の例では、cURLを使用してRESTリソースに対するPOSTリクエストを発行することによって、セキュリティ・アプリケーションを追加する方法を示しています。 cURLの詳細は、「cURLの使用」を参照してください。

コマンドを1行で入力します。この例では、読みやすくするために改行が使用されています。

curl -i -X POST
     -H "Cookie: $COMPUTE_COOKIE"
     -H "Content-Type: application/oracle-compute-v3+json"
     -H "Accept: application/oracle-compute-v3+json"
     -d "@requestbody.json"
        https://api-z999.compute.us0.oraclecloud.com/secapplication/

COMPUTE_COOKIEは、前の手順で認証cookieを格納した変数の名前です。認証クッキーの取得および変数への格納の詳細は、認証を参照してください。
api-z999.compute.us0.oraclecloud.comはRESTエンドポイントURLの例です。この値をCompute ClassicサイトのRESTエンドポイントURLに変更します。サイトのRESTエンドポイントURLを見つける方法については、「リクエストの送信」を参照してください。

リクエスト本文の例

次の例では、/Compute-acme/jack.jones@example.com/vid_stream_udpというセキュリティ・アプリケーションを作成するためのrequestbody.jsonファイルのリクエスト本文の内容を示しています。

いくつかの行は、読みやすくするために省略記号(...)で切り捨てられます。

{
 "protocol": "udp",
 "name": "/Compute-acme/jack.jones@example.com/vid_stream_udp",
 "dport": "70",
}

レスポンス本文の例

次の例は、レスポンス本文をJSON形式で示しています。

いくつかの行は、読みやすくするために省略記号(...)で切り捨てられます。

{
 "protocol": "udp",
 "name": "/Compute-acme/jack.jones@example.com/vid_stream_udp",
 "uri": "https://api-z999.compute.us0.oraclecloud.com/secapplication/Compute-acme/jack.jones@example.com/vid_stream_udp",
 "icmptype": "",
 "dport": "70",
 "icmpcode": ""
}

トップに戻る