2020年4月

さくらクラウドVPCルータ（サイト間VPN)とOpenVPNを利用したVPN拠点の構築

昨今、コロナ禍により業務を遂行するにあたり、テレワークを余儀なくされてます。

社内のNASやら、運用・保守業務で「IPアドレス制限されている」サーバにアクセスするために、会社ルータ（RTX-1210)にVPN接続をすることが多々発生しています。

そうした中、RTX-1210にVPN（L2TP）接続ができないというスタッフが続々と発生するという問題が顕著化しました。（以前よりそういった問題がちょくちょくありましたが、特に業務への影響は軽微であったことから、放置していました。）

ログ、コンフィグなどを見直して、ある程度あたりはつけましたが、業務に影響がでるかもしれない作業を実施する時間的余裕もないのと、本当にそれで問題が解消する保証もないのと、別件で使ってる拠点間接続だと、通信が安定しているという事もあり、　外部にVPNサーバを立てて、そいつと、会社のRTX-1210を拠点間接続でつないでしまえばいいのじゃなかろうかと思い立ったが吉事。さっそくやってみました。

さくらクラウドのVPCルータにもVPN（L2TP)サービスがあるので、最初これが使えるか？と試したのですが、VPCルータから全パケットを拠点間接続の接続先に転送するルーティングを入れると、VPN(L2TP)サービスに接続できなくなってしまうという問題（というかあたりまえなんですが。。）があり、以下のようなネットワークを作ってみました。

簡単に説明すると、さくらVPCルータを拠点間接続だけに利用して、VPNサーバは別にサーバを立てて、VPNクライアントから接続されたパケットはすべて、VPCルータ経由・拠点間VPN接続を得て会社のRTX-1210から出ていくルーティングを設定するというものです。

つまり、以下のような通信ラインを確保しようという試みです。

以下構築の手順メモ

OpenVPNを設定する

【設定前提情報】

ローカルスイッチネットワーク情報：　192.168.100.0/23
接続先スイッチ：　local-switch(1)
サーバのNetwork:　eth0 （Global側） 30.30.30.1
サーバのNetwork:　eth1 （Loal側） 192.168.100.2
OS: CentOS 7.6

【手順】

STEP1) 必要パッケージをインストールする

yum -y update<br>yum install epel-release -y<br>yum --enablerepo=epel -y install openvpn easy-rsa

1	yum -y update<br>yum install epel-release -y<br>yum --enablerepo=epel -y install openvpn easy-rsa

STEP2) 各種設定準備を行う
※パスワード、CAのcommonnameは好きな値を設定の事

mkdir /etc/openvpn/easy-rsa<br>cp /usr/share/easy-rsa/3.0.7/* /etc/openvpn/easy-rsa/ -R

1	mkdir /etc/openvpn/easy-rsa<br>cp /usr/share/easy-rsa/3.0.7/* /etc/openvpn/easy-rsa/ -R

cd /etc/openvpn/easy-rsa

1	cd /etc/openvpn/easy-rsa

./easyrsa init-pki<br>./easyrsa build-ca<br>./easyrsa gen-dh<br>./easyrsa build-server-full server_r nopass<br>./easyrsa build-client-full client1 nopass<br>openvpn --genkey --secret /etc/openvpn/ta.key<br>cd /etc/openvpn/<br>cp /usr/share/doc/openvpn*/sample/sample-config-files/server.conf server_r.conf

./easyrsa init-pki ./easyrsa build-ca ./easyrsa gen-dh ./easyrsa build-server-full server_r nopass ./easyrsa build-client-full client1 nopass openvpn --genkey --secret /etc/openvpn/ta.key cd /etc/openvpn/ cp /usr/share/doc/openvpn*/sample/sample-config-files/server.conf server_r.conf

STEP3)　server_r.confの設定を行う

vi /etc/openvpn/server_r.conf

1	vi /etc/openvpn/server_r.conf

デフォルト値から以下を変更する

ca /etc/openvpn/easy-rsa/pki/ca.crt
cert /etc/openvpn/easy-rsa/pki/issued/server_r.crt
key /etc/openvpn/easy-rsa/pki/private/server_r.key  # This file should be kept secret
dh /etc/openvpn/easy-rsa/pki/dh.pem
push "route 192.168.0.0 255.255.255.0"
push "redirect-gateway def1 bypass-dhcp"
comp-lzo
user nobody
group nobody
status /var/log/openvpn-status.log
log         /var/log/openvpn.log
log-append  /var/log/openvpn.log

ca /etc/openvpn/easy-rsa/pki/ca.crt

cert /etc/openvpn/easy-rsa/pki/issued/server_r.crt

key /etc/openvpn/easy-rsa/pki/private/server_r.key # This file should be kept secret

dh /etc/openvpn/easy-rsa/pki/dh.pem

push "route 192.168.0.0 255.255.255.0"

push "redirect-gateway def1 bypass-dhcp"

comp-lzo

user nobody

group nobody

status /var/log/openvpn-status.log

log /var/log/openvpn.log

log-append /var/log/openvpn.log

STEP4)　net.ipv4.ip_forward の設定を行う

vi /etc/sysctl.d/10-ipv4_forward.conf

1	vi /etc/sysctl.d/10-ipv4_forward.conf

net.ipv4.ip_forward = 1

1	net.ipv4.ip_forward = 1

sysctl --system

1	sysctl --system

STEP5)　iptablesの設定を行う

yum -y install iptables-services<br>systemctl disable firewalld<br>systemctl stop firewalld<br>systemctl enabled iptables<br>systemctl start iptables

1	yum -y install iptables-services<br>systemctl disable firewalld<br>systemctl stop firewalld<br>systemctl enabled iptables<br>systemctl start iptables

vi /etc/sysconfig/iptables

1	vi /etc/sysconfig/iptables

*filter
 :INPUT ACCEPT [0:0]
 :FORWARD ACCEPT [0:0]
 :OUTPUT ACCEPT [6:813]
 -A INPUT -m state --state RELATED,ESTABLISHED -j ACCEPT
 -A INPUT -p icmp -j ACCEPT
 -A INPUT -i lo -j ACCEPT
<strong> -A INPUT -p udp -m udp --dport 1194 -j ACCEPT
</strong> -A INPUT -p tcp -m state --state NEW -m tcp --dport 22 -j ACCEPT
 -A INPUT -j REJECT --reject-with icmp-host-prohibited
<strong> -A FORWARD -d 192.168.100.0/23 -i tun+ -j ACCEPT
</strong> -A FORWARD -o eth0 -m state --state NEW -j ACCEPT
 -A FORWARD -o eth1 -m state --state NEW -j ACCEPT
 -A FORWARD -m state --state RELATED,ESTABLISHED -j ACCEPT
 -A FORWARD -j REJECT --reject-with icmp-host-prohibited
 COMMIT
<strong> *nat
</strong> :PREROUTING ACCEPT [51:3492]
 :INPUT ACCEPT [0:0]
 :OUTPUT ACCEPT [2:152]
 :POSTROUTING ACCEPT [3:212]
<strong> -A POSTROUTING -s 10.8.0.0/24 -o eth1 -j MASQUERADE
</strong> COMMIT

*filter

:INPUT ACCEPT [0:0]

:FORWARD ACCEPT [0:0]

:OUTPUT ACCEPT [6:813]

-A INPUT -m state --state RELATED,ESTABLISHED -j ACCEPT

-A INPUT -p icmp -j ACCEPT

-A INPUT -i lo -j ACCEPT

-A INPUT -p udp -m udp --dport 1194 -j ACCEPT

-A INPUT -p tcp -m state --state NEW -m tcp --dport 22 -j ACCEPT

-A INPUT -j REJECT --reject-with icmp-host-prohibited

-A FORWARD -d 192.168.100.0/23 -i tun+ -j ACCEPT

-A FORWARD -o eth0 -m state --state NEW -j ACCEPT

-A FORWARD -o eth1 -m state --state NEW -j ACCEPT

-A FORWARD -m state --state RELATED,ESTABLISHED -j ACCEPT

-A FORWARD -j REJECT --reject-with icmp-host-prohibited

COMMIT

*nat

:PREROUTING ACCEPT [51:3492]

:INPUT ACCEPT [0:0]

:OUTPUT ACCEPT [2:152]

:POSTROUTING ACCEPT [3:212]

-A POSTROUTING -s 10.8.0.0/24 -o eth1 -j MASQUERADE

COMMIT

※ボールドの部分がポイント

systemctl restart iptables

1	systemctl restart iptables

STEP6) OpenVPN起動

systemctl enable openvpn@server_r<br>systemctl start openvpn@server_r

1	systemctl enable openvpn@server_r<br>systemctl start openvpn@server_r

STEP7) ルーティングの設定

ip rule add from 10.8.0.0/24 table 100 prio 100

1	ip rule add from 10.8.0.0/24 table 100 prio 100

ip route add 10.8.0.0/24 dev eth0 proto kernel scope link metric 100 table 100

1	ip route add 10.8.0.0/24 dev eth0 proto kernel scope link metric 100 table 100

ip route add default via 192.168.100.1 table 100

1	ip route add default via 192.168.100.1 table 100

※このルーティングがポイント（10.8.0.0/24からのパケットは全部、192.168.100.1へルーティングするという内容を用意する）

STEP7)　ルーティングの永続化

※設定方法確認中
　とりあえずいまは起動時にスクリプトで実行させておく。

STEP8)　クライアントで利用するcert / keyは以下ファイルを利用する

/etc/openvpn/easy-rsa/pki/ca.crt
/etc/openvpn/ta.key
/etc/openvpn/easy-rsa/pki/issued/client1.crt
/etc/openvpn/easy-rsa/pki/private/client1.key

.ovpnファイルを作ると接続設定するのが楽になります。
以下のようなファイルを作る

client
 dev             tun
 proto           udp
 remote          30.30.30.1 1194
 resolv-retry infinite
 nobind
 persist-key
 persist-tun
 remote-cert-tls server
 tls-client
 key-direction 1
 cipher AES-256-CBC
 comp-lzo
 verb 3
<ca>
 ここに、「/etc/openvpn/easy-rsa/pki/ca.crt」の内容を張り付ける 
</ca>
<key>
 ここに、「/etc/openvpn/easy-rsa/pki/private/client1.key」の内容を張り付ける 
</key>
<cert>
 ここに、「/etc/openvpn/easy-rsa/pki/issued/client1.crt」の内容を張り付ける 
</cert>
<tls-auth>
 ここに、「/etc/openvpn/ta.key」の内容を張り付ける 
</tls-auth>

client

dev tun

proto udp

remote 30.30.30.1 1194

resolv-retry infinite

nobind

persist-key

persist-tun

remote-cert-tls server

tls-client

key-direction 1

cipher AES-256-CBC

comp-lzo

verb 3

<ca>

ここに、「/etc/openvpn/easy-rsa/pki/ca.crt」の内容を張り付ける

</ca>

<key>

ここに、「/etc/openvpn/easy-rsa/pki/private/client1.key」の内容を張り付ける

</key>

<cert>

ここに、「/etc/openvpn/easy-rsa/pki/issued/client1.crt」の内容を張り付ける

</cert>

<tls-auth>

ここに、「/etc/openvpn/ta.key」の内容を張り付ける

</tls-auth>

さくらクラウド VPCを利用した「拠点間VPN接続」の設定を行う。

さくらクラウドVPCの設定を行う

■さくらクラウド　ネットワーク情報

【設定前提情報】
ローカルスイッチネットワーク情報：　192.168.100.0/23
接続先スイッチ：　local-switch(1)
VPCルーター（インターフェース：プライベート１）に割り当てるIP： 192.168.100.1
対向IPアドレス： 10.10.10.1
対向ID： 192.168.100.1
Pre Shared Secret: unko123
対向Prefix: 0.0.0.0/0
ローカルPrefix: 192.168.100.0/23

【手順】

STEP1) VPCルーターを追加する
　　　　プラン：　スタンダード
　　　　インターネット接続：　有効
　　　　そのほかの項目は任意で入力する
　　　　
STEP2) VPCルーターのインターフェースの設定
　　　　スイッチ：　既存スイッチを接続
　　　　接続先スイッチ：　local-switch(1)
　　　　IPアドレス：　192.168.100.1
　　　　プレフィックス： /23

STEP3)　サイト間VPNの設定
　　　　対向IPアドレス： 10.10.10.1
　　　　対向ID： 192.168.100.1
　　　　Pre Shared Secret: unko123
　　　　対向Prefix: 0.0.0.0/0
　　　　ローカルPrefix: 192.168.100.0/23

STEP4)　「反映」を行う

RTX-1210側の設定を行う

【設定前提情報】
■RTX-1210ネットワーク情報
Global-IP:　 10.10.10.1
LAN-IP: 172.16.100.1 (NetworkAddress: 172.16.100.0/23)
■さくらクラウド VPC（サイト間VPN設定情報）
Global-IP: 20.20.20.1
対向IPアドレス： 10.10.10.1
対向ID： 192.168.100.1
Pre Shared Secret: unko123
対向Prefix: 0.0.0.0/0
ローカルPrefix: 192.168.100.0/23

【手順】

★RTX-1210側への設定手順
参考：　https://knowledge.sakura.ad.jp/7051/

１）　RTX-1210のGUIツールにて、拠点間VPNの設定を行う。　（簡単設定→VPN→拠点間接続）
　接続種別の選択： IPSec
　ネットワーク環境：自分側と接続先の両方とも固定のグローバルアドレスまたはネットボランチDNSホスト名を持っている
　自分側の設定（設定名）： SAKURA VPN
　接続先の情報（接続先のホスト名またはIPアドレス）： 10.10.10.1
接続先と合わせる設定（認証鍵 (pre-shared key)）： unko123
接続先と合わせる設定（認証アルゴリズム）： HMAC-SHA
接続先と合わせる設定（暗号アルゴリズム）： AES-CBC
　経路に関する設定：接続先のLAN側のアドレス
192.168.100.0 / 255.255.254.0(23bit)
10.8.0.0 / 255.255.254.0(24bit)
２）　CONFIGを取得して、「description tunnel “SAKURA VPN”」の設定部分を探して、設定情報を変更する

※例えば、

tunnel select 16
 description tunnel "SAKURA VPN"
 ipsec tunnel 9
  ipsec sa policy 9 9 esp aes-cbc sha-hmac
  ipsec ike keepalive log 9 off
  ipsec ike keepalive use 9 on heartbeat 10 6
  ipsec ike local address 9 172.16.100.1
  ipsec ike nat-traversal 9 on
  ipsec ike pre-shared-key 9 text unko123
  ipsec ike remote address 9 20.20.20.1
 ip tunnel tcp mss limit auto
 tunnel enable 16

tunnel select 16

description tunnel "SAKURA VPN"

ipsec tunnel 9

ipsec sa policy 9 9 esp aes-cbc sha-hmac

ipsec ike keepalive log 9 off

ipsec ike keepalive use 9 on heartbeat 10 6

ipsec ike local address 9 172.16.100.1

ipsec ike nat-traversal 9 on

ipsec ike pre-shared-key 9 text unko123

ipsec ike remote address 9 20.20.20.1

ip tunnel tcp mss limit auto

tunnel enable 16

であった場合、以下のような設定情報を作成。

tunnel select 16
  description tunnel "SAKURA VPN"
  ipsec tunnel 9
   ipsec sa policy 9 9 esp aes-cbc sha-hmac
   ipsec ike always-on 9 on
   ipsec ike duration ipsec-sa 9 1800
   ipsec ike duration ike-sa 9 28800
   ipsec ike encryption 9 aes-cbc
   ipsec ike group 9 modp1024
   ipsec ike hash 9 sha
   ipsec ike keepalive log 9 off
   ipsec ike keepalive use 9 on dpd 15 2
   ipsec ike local address 9 172.16.100.1
   ipsec ike local id 9 172.16.100.0/23
   ipsec ike nat-traversal 9 off
   ipsec ike pfs 9 on
   ipsec ike pre-shared-key 9 text unko123
   ipsec ike remote address 9 20.20.20.1
   ipsec ike remote id 9 192.168.100.0/23
   ipsec auto refresh 9 on
  ip tunnel mtu 1280
  ip tunnel tcp mss limit auto
  tunnel enable 16

tunnel select 16

description tunnel "SAKURA VPN"

ipsec tunnel 9

ipsec sa policy 9 9 esp aes-cbc sha-hmac

ipsec ike always-on 9 on

ipsec ike duration ipsec-sa 9 1800

ipsec ike duration ike-sa 9 28800

ipsec ike encryption 9 aes-cbc

ipsec ike group 9 modp1024

ipsec ike hash 9 sha

ipsec ike keepalive log 9 off

ipsec ike keepalive use 9 on dpd 15 2

ipsec ike local address 9 172.16.100.1

ipsec ike local id 9 172.16.100.0/23

ipsec ike nat-traversal 9 off

ipsec ike pfs 9 on

ipsec ike pre-shared-key 9 text unko123

ipsec ike remote address 9 20.20.20.1

ipsec ike remote id 9 192.168.100.0/23

ipsec auto refresh 9 on

ip tunnel mtu 1280

ip tunnel tcp mss limit auto

tunnel enable 16

これを、RTX-1210の「コマンド実行」で実行する。

以上

C#でWOL（Wake-on-LAN）

福岡の香月です。

コロナ対応で世の中はリモートワークが進んでいるようです。中程度スペックの中古PCもたくさん売れているようで、在庫が少なくなっているようですね。

自宅作業する場合、会社のPCにリモートデスクトップでつないで作業することも多いと思いますが、気付いたらPCがシャットダウンしていることがあります。間違って電源切ったとか、夜中にWindows Updateが動いたとか。

そんな時はWOL（Wake-on-LAN）ですが、私はこれについて知識が無かったので調べがてらC#プログラムのWOLツールを作ってみました。プラットフォームは.Net Core 3.1です。
以下全文です。どん！

[crayon-661e46e198127050321110  ]
using System;
using System.IO;
using System.Net.Sockets;
using System.Reflection;
using Microsoft.Extensions.Configuration;

namespace WakeOnLAN
{
    class Program
    {
        static void Main(string[] args)
        {
            string name = Assembly.GetEntryAssembly().GetName().Name;
            ConfigurationBuilder builder = new ConfigurationBuilder();
            builder.SetBasePath(Directory.GetCurrentDirectory());
            builder.AddIniFile(name + ".ini");
            IConfiguration config = builder.Build();

            string host = config["host"];
            string sport = config["port"];
            string macAddr = config["macAddr"];

            if (string.IsNullOrEmpty(host))
            {
                Console.WriteLine("設定ファイルに host が設定されていません。");
                return;
            }
            if (string.IsNullOrEmpty(sport))
            {
                Console.WriteLine("設定ファイルに port が設定されていません。");
                return;
            }
            if (string.IsNullOrEmpty(macAddr))
            {
                Console.WriteLine("設定ファイルに macAddr が設定されていません。");
                return;
            }

            int port = 0;
            if (!int.TryParse(sport, out port))
            {
                Console.WriteLine("ポート番号が不正です。");
                return;
            }

            // macアドレス文字列をバイト配列に
            string[] bsary = macAddr.Split('-');
            if (bsary.Length != 6)
            {
                Console.WriteLine("macアドレスが正しくありません。\nipconfig /all で確認してください。\n例）1A-2B-3C-D4-EE-99");
                return;
            }
            byte[] bmac = new byte[6];
            for (int i = 0; i &lt; 6; ++i)
                bmac[i] = Convert.ToByte(bsary[i], 16);

            byte[] packet = new byte[6 + 6 * 16];
            Array.Copy(new byte[] { 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF }, 0, packet, 0, 6);
            for (int i=1; i&lt;=16; ++i)
                Array.Copy(bmac, 0, packet, i * bmac.Length, bmac.Length);

            try
            {
                UdpClient udp = new UdpClient();
                udp.Send(packet, packet.Length, host, port);
            }
            catch (Exception e)
            {
                Console.WriteLine("マジックパケットの送信時に例外が発生しました。\n" + e.ToString());
            }
        }
    }
}

[crayon-661e46e198127050321110 ]

using System;

using System.IO;

using System.Net.Sockets;

using System.Reflection;

using Microsoft.Extensions.Configuration;

namespace WakeOnLAN

{

class Program

{

static void Main(string[] args)

{

string name = Assembly.GetEntryAssembly().GetName().Name;

ConfigurationBuilder builder = new ConfigurationBuilder();

builder.SetBasePath(Directory.GetCurrentDirectory());

builder.AddIniFile(name + ".ini");

IConfiguration config = builder.Build();

string host = config["host"];

string sport = config["port"];

string macAddr = config["macAddr"];

if (string.IsNullOrEmpty(host))

{

Console.WriteLine("設定ファイルに host が設定されていません。");

return;

}

if (string.IsNullOrEmpty(sport))

{

Console.WriteLine("設定ファイルに port が設定されていません。");

return;

}

if (string.IsNullOrEmpty(macAddr))

{

Console.WriteLine("設定ファイルに macAddr が設定されていません。");

return;

}

int port = 0;

if (!int.TryParse(sport, out port))

{

Console.WriteLine("ポート番号が不正です。");

return;

}

// macアドレス文字列をバイト配列に

string[] bsary = macAddr.Split('-');

if (bsary.Length != 6)

{

Console.WriteLine("macアドレスが正しくありません。\nipconfig /all で確認してください。\n例）1A-2B-3C-D4-EE-99");

return;

}

byte[] bmac = new byte[6];

for (int i = 0; i < 6; ++i)

bmac[i] = Convert.ToByte(bsary[i], 16);

byte[] packet = new byte[6 + 6 * 16];

Array.Copy(new byte[] { 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF }, 0, packet, 0, 6);

for (int i=1; i<=16; ++i)

Array.Copy(bmac, 0, packet, i * bmac.Length, bmac.Length);

try

{

UdpClient udp = new UdpClient();

udp.Send(packet, packet.Length, host, port);

}

catch (Exception e)

{

Console.WriteLine("マジックパケットの送信時に例外が発生しました。\n" + e.ToString());

}

[/crayon]

特徴

マジックパケットを飛ばします。マジックパケットとは…
- UDPで送信するパケット
- 先頭6バイトに{ 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF }
- 続けて対象PCのmacアドレスを16回
- 合わせて102バイトのパケットとなる。
exeと同じ名前のiniファイルを設定ファイルとして読み込む
設定ファイルにて以下を設定
- host=対象PCのIPアドレス
- post=UDPポート（ルータが許可したポートであれば何でもOK）
- macアドレス=対象PCのmacアドレス
エラーが発生した場合はコンソール上にエラーを表示

プログラムは案外簡単でびっくりしました。
それよりもWOLが使える環境の設定が大変そうですね。BIOS、ネットワークカード、Windowsの設定など、情報はぐぐればいろいろ出てきますので一度お試しあれ。

Swagger-PHPでOA\PathItem()エラー

福岡拠点の野田です。
OpenAPI(Swagger)の仕様書を使っていますか？

PHPでは、アノテーションでOpenAPIを定義できるSwagger-PHPというものがあります。使うためには以下を実行します。

[crayon-661e46e1985ee525053012  ]composer require --dev zircote/swagger-php

1	[crayon-661e46e1985ee525053012 ]composer require --dev zircote/swagger-php

[/crayon]

対象のコントローラーを指定するとアノテーションで記載したコメントがAPI仕様書になるという素晴らしいライブラリです。swagger.ymlの書き出し方は、以下。

[crayon-661e46e1985f7698679391  ]vendor/zircote/swagger-php/bin/openapi app/Http/Controllers/Api/*Controller.php -o swagger.yml

1	[crayon-661e46e1985f7698679391 ]vendor/zircote/swagger-php/bin/openapi app/Http/Controllers/Api/*Controller.php -o swagger.yml

[/crayon]

ここで少しはまりどころがあります。
OA\Infoを定義したクラスには必ずOA\GetやOA\PutといったAPIをセットで定義しなければなりません。それをしないと以下のエラーで怒られます。

[crayon-661e46e198600857749110  ]Required @OA\PathItem() not found

1	[crayon-661e46e198600857749110 ]Required @OA\PathItem() not found

[/crayon]

ちょー分かりにくいエラーなので、私もはまりました。そんなときは汎用エラーレスポンスでも定義してしのぎましょう。

[crayon-661e46e198608453762255  ]    /**
     * @OA\Put(
     *     path="/api/*",
     *     tags={"ErrorCommon"},
     *     description="APIエラー共通",
     *     @OA\Response(
     *          response="default",
     *          description="APIエラー時の返却データ",
     *          @OA\JsonContent(
     *              @OA\Property(property="error", type="integer", description="エラー値(0:正常/1:エラー)"),
     *              @OA\Property(property="errorId", type="string", description="エラーID"),
     *              @OA\Property(property="code", type="string", description="エラーコード"),
     *              @OA\Property(property="message", type="string", description="エラーメッセージ"),
     *          )
     *     )
     * ),
     */
    private function error() {
        throw new UnsupportedOperationException();
    }

[crayon-661e46e198608453762255 ] /**

* @OA\Put(

* path="/api/*",

* tags={"ErrorCommon"},

* description="APIエラー共通",

* @OA\Response(

* response="default",

* description="APIエラー時の返却データ",

* @OA\JsonContent(

* @OA\Property(property="error", type="integer", description="エラー値(0:正常/1:エラー)"),

* @OA\Property(property="errorId", type="string", description="エラーID"),

* @OA\Property(property="code", type="string", description="エラーコード"),

* @OA\Property(property="message", type="string", description="エラーメッセージ"),

* )

* ),

private function error() {

throw new UnsupportedOperationException();

}

[/crayon]

これはライブラリ側でなんとかしてほしかったところではありますが、めげずにswaggerを使っていきましょう。

それでは、また！

2020年4月
月	火	水	木	金	土	日
		1	2	3	4	5
6	7	8	9	10	11	12
13	14	15	16	17	18	19
20	21	22	23	24	25	26
27	28	29	30