2.13. セキュリティー

手順

1. Web コンソールにログインします。
2. Project メニューをクリックし、Service Mesh コントロールプレーンをインストールしたプロジェクト (例: istio-system) を選択します。
3. Operators Installed Operators をクリックします。
4. Provided APIs の Service Mesh Control Plane をクリックします。
5. ServiceMeshControlPlane リソースの名前 (例: basic) をクリックします。
6. Details ページで、Data Plane Security の Security セクションでトグルをクリックします。

1. Maistra リポジトリー のサンプル証明書をローカルに保存し、<path> を証明書へのパスに置き換えます。

2. cacert という名前のシークレットを作成します。これには、入力ファイルの ca-cert.pem、ca-key.pem、root-cert.pem および cert-chain.pem が含まれます。

   $ oc create secret generic cacerts -n istio-system --from-file=<path>/ca-cert.pem \
       --from-file=<path>/ca-key.pem --from-file=<path>/root-cert.pem \
       --from-file=<path>/cert-chain.pem

   Copy to Clipboard Toggle word wrap

3. ServiceMeshControlPlane リソースで、spec.security.dataPlane.mtls true を true に設定し、以下の例のように certificateAuthority フィールドを設定します。デフォルトの rootCADir は /etc/cacerts です。キーおよび証明書がデフォルトの場所にマウントされている場合は、privateKey を設定する必要はありません。Service Mesh は、secret-mount ファイルから証明書およびキーを読み取ります。

   apiVersion: maistra.io/v2
   kind: ServiceMeshControlPlane
   spec:
     security:
       dataPlane:
         mtls: true
       certificateAuthority:
         type: Istiod
         istiod:
           type: PrivateKey
           privateKey:
             rootCADir: /etc/cacerts

   Copy to Clipboard Toggle word wrap

4. cacert シークレットを作成/変更/削除した後に、変更を有効にするために、Service Mesh コントロールプレーンの istiod と gateway Pod を再起動する必要があります。以下のコマンドで Pod を再起動します。

   $ oc -n istio-system delete pods -l 'app in (istiod,istio-ingressgateway, istio-egressgateway)'

   Copy to Clipboard Toggle word wrap

   Operator は、Pod を削除した後、自動的に再作成します。

5. info アプリケーションの Pod を再起動し、sidecar プロキシーがシークレットの変更を取り込むようにします。以下のコマンドで Pod を再起動します。

   $ oc -n info delete pods --all

   Copy to Clipboard Toggle word wrap

   以下のような出力が表示されるはずです。

   pod "details-v1-6cd699df8c-j54nh" deleted
   pod "productpage-v1-5ddcb4b84f-mtmf2" deleted
   pod "ratings-v1-bdbcc68bc-kmng4" deleted
   pod "reviews-v1-754ddd7b6f-lqhsv" deleted
   pod "reviews-v2-675679877f-q67r2" deleted
   pod "reviews-v3-79d7549c7-c2gjs" deleted

   Copy to Clipboard Toggle word wrap

6. 以下のコマンドで、Pod が作成され、準備ができたことを確認します。

   $ oc get pods -n info

   Copy to Clipboard Toggle word wrap

1. info ワークロードから証明書を抽出するには、以下のコマンドを使用します。

   $ sleep 60
   $ oc -n info exec "$(oc -n bookinfo get pod -l app=productpage -o jsonpath={.items..metadata.name})" -c istio-proxy -- openssl s_client -showcerts -connect details:9080 > bookinfo-proxy-cert.txt
   $ sed -n '/-----BEGIN CERTIFICATE-----/{:start /-----END CERTIFICATE-----/!{N;b start};/.*/p}' info-proxy-cert.txt > certs.pem
   $ awk 'BEGIN {counter=0;} /BEGIN CERT/{counter++} { print > "proxy-cert-" counter ".pem"}' < certs.pem

   Copy to Clipboard Toggle word wrap

   コマンドを実行すると、作業ディレクトリーに proxy-cert-1.pem、proxy-cert-2.pem、proxy-cert-3.pem の 3 つのファイルが作成されるはずです。

2. ルート証明書が管理者が指定したものと同じであることを確認します。<path> を証明書へのパスに置き換えます。

   $ openssl x509 -in <path>/root-cert.pem -text -noout > /tmp/root-cert.crt.txt

   Copy to Clipboard Toggle word wrap

   ターミナルウィンドウで次の構文を実行します。

   $ openssl x509 -in ./proxy-cert-3.pem -text -noout > /tmp/pod-root-cert.crt.txt

   Copy to Clipboard Toggle word wrap

   ターミナルウィンドウで以下の構文を実行して、証明書を比較します。

   $ diff -s /tmp/root-cert.crt.txt /tmp/pod-root-cert.crt.txt

   Copy to Clipboard Toggle word wrap

   以下のような結果が表示されるはずです: Files /tmp/root-cert.crt.txt and /tmp/pod-root-cert.crt.txt are identical

3. CA 証明書が管理者が指定したものと同じであることを確認します。<path> を証明書へのパスに置き換えます。

   $ openssl x509 -in <path>/ca-cert.pem -text -noout > /tmp/ca-cert.crt.txt

   Copy to Clipboard Toggle word wrap

   ターミナルウィンドウで次の構文を実行します。

   $ openssl x509 -in ./proxy-cert-2.pem -text -noout > /tmp/pod-cert-chain-ca.crt.txt

   Copy to Clipboard Toggle word wrap

   ターミナルウィンドウで以下の構文を実行して、証明書を比較します。

   $ diff -s /tmp/ca-cert.crt.txt /tmp/pod-cert-chain-ca.crt.txt

   Copy to Clipboard Toggle word wrap

   以下のような結果が表示されるはずです: Files /tmp/ca-cert.crt.txt and /tmp/pod-cert-chain-ca.crt.txt are identical.

4. ルート証明書からワークロード証明書への証明書チェーンを確認します。<path> を証明書へのパスに置き換えます。

   $ openssl verify -CAfile <(cat <path>/ca-cert.pem <path>/root-cert.pem) ./proxy-cert-1.pem

   Copy to Clipboard Toggle word wrap

   以下のような出力が表示されるはずです: ./proxy-cert-1.pem: OK

1. シークレット cacerts を削除します。この例では、istio-system が Service Mesh コントロールプレーンプロジェクトの名前となります。

   $ oc delete secret cacerts -n istio-system

   Copy to Clipboard Toggle word wrap

2. ServiceMeshControlPlane リソースで自己署名ルート証明書を使用して Service Mesh を再デプロイします。

   apiVersion: maistra.io/v2
   kind: ServiceMeshControlPlane
   spec:
     security:
       dataPlane:
         mtls: true

   Copy to Clipboard Toggle word wrap

手順

1. ルートクラスターの発行者を作成します。

   1. 次の例のように cluster-issuer オブジェクトを作成します。

      cluster-issuer.yaml の例

      apiVersion: cert-manager.io/v1
      kind: Issuer
      metadata:
        name: selfsigned-root-issuer
        namespace: cert-manager
      spec:
        selfSigned: {}
      ---
      apiVersion: cert-manager.io/v1
      kind: Certificate
      metadata:
        name: root-ca
        namespace: cert-manager
      spec:
        isCA: true
        duration: 21600h # 900d
        secretName: root-ca
        commonName: root-ca.my-company.net
        subject:
          organizations:
          - my-company.net
        issuerRef:
          name: selfsigned-root-issuer
          kind: Issuer
          group: cert-manager.io
      ---
      apiVersion: cert-manager.io/v1
      kind: ClusterIssuer
      metadata:
        name: root-ca
      spec:
        ca:
          secretName: root-ca

      Copy to Clipboard Toggle word wrap

      注記

      root-ca がクラスター発行者であるため、selfsigned-root-issuer の発行者と root-ca 証明書の namespace は cert-manager です。そのため、cert-manager は参照されるシークレットを独自の namespace で検索します。Red Hat OpenShift の cert-manager Operator の場合、namespace の名前は cert-manager です。

   2. 次のコマンドを使用してオブジェクトを作成します。

      $ oc apply -f cluster-issuer.yaml

      Copy to Clipboard Toggle word wrap

   3. 次の例のように istio-ca オブジェクトを作成します。

      istio-ca.yaml の例

      apiVersion: cert-manager.io/v1
      kind: Certificate
      metadata:
        name: istio-ca
        namespace: istio-system
      spec:
        isCA: true
        duration: 21600h
        secretName: istio-ca
        commonName: istio-ca.my-company.net
        subject:
          organizations:
          - my-company.net
        issuerRef:
          name: root-ca
          kind: ClusterIssuer
          group: cert-manager.io
      ---
      apiVersion: cert-manager.io/v1
      kind: Issuer
      metadata:
        name: istio-ca
        namespace: istio-system
      spec:
        ca:
          secretName: istio-ca

      Copy to Clipboard Toggle word wrap

   4. 次のコマンドを使用してオブジェクトを作成します。

      $ oc apply -n istio-system -f istio-ca.yaml

      Copy to Clipboard Toggle word wrap

2. istio-csr をインストールします。

   $ helm install istio-csr jetstack/cert-manager-istio-csr \
       -n istio-system \
       -f deploy/examples/cert-manager/istio-csr/istio-csr.yaml

   Copy to Clipboard Toggle word wrap

   istio-csr.yaml の例

   replicaCount: 2
   
   image:
     repository: quay.io/jetstack/cert-manager-istio-csr
     tag: v0.6.0
     pullSecretName: ""
   
   app:
     certmanager:
       namespace: istio-system
       issuer:
         group: cert-manager.io
         kind: Issuer
         name: istio-ca
   
     controller:
       configmapNamespaceSelector: "maistra.io/member-of=istio-system"
       leaderElectionNamespace: istio-system
   
     istio:
       namespace: istio-system
       revisions: ["basic"]
   
     server:
       maxCertificateDuration: 5m
   
     tls:
       certificateDNSNames:
       # This DNS name must be set in the SMCP spec.security.certificateAuthority.cert-manager.address
       - cert-manager-istio-csr.istio-system.svc

   Copy to Clipboard Toggle word wrap

3. SMCP をデプロイメントします。

   $ oc apply -f mesh.yaml -n istio-system

   Copy to Clipboard Toggle word wrap

   例 mesh.yaml

   apiVersion: maistra.io/v2
   kind: ServiceMeshControlPlane
   metadata:
     name: basic
   spec:
     addons:
       grafana:
         enabled: false
       kiali:
         enabled: false
       prometheus:
         enabled: false
     proxy:
       accessLogging:
         file:
           name: /dev/stdout
     security:
       certificateAuthority:
         cert-manager:
           address: cert-manager-istio-csr.istio-system.svc:443
         type: cert-manager
       dataPlane:
         mtls: true
       identity:
         type: ThirdParty
     tracing:
       type: None
   ---
   apiVersion: maistra.io/v1
   kind: ServiceMeshMemberRoll
   metadata:
     name: default
   spec:
     members:
     - httpbin
     - sleep

   Copy to Clipboard Toggle word wrap

1. HTTP アプリと sleep アプリをデプロイします。

   $ oc new-project <namespace>

   Copy to Clipboard Toggle word wrap

   $ oc apply -f https://raw.githubusercontent.com/maistra/istio/maistra-2.4/samples/httpbin/httpbin.yaml

   Copy to Clipboard Toggle word wrap

   $ oc apply -f https://raw.githubusercontent.com/maistra/istio/maistra-2.4/samples/sleep/sleep.yaml

   Copy to Clipboard Toggle word wrap

2. sleep が httpbin サービスにアクセスできることを確認します。

   $ oc exec "$(oc get pod -l app=sleep -n <namespace> \
      -o jsonpath={.items..metadata.name})" -c sleep -n <namespace> -- \
      curl http://httpbin.<namespace>:8000/ip -s -o /dev/null \
      -w "%{http_code}\n"

   Copy to Clipboard Toggle word wrap

   出力例

   200

   Copy to Clipboard Toggle word wrap

3. Ingress ゲートウェイから httpbin サービスへの mTLS トラフィックを確認します。

   $ oc apply -n <namespace> -f https://raw.githubusercontent.com/maistra/istio/maistra-2.4/samples/httpbin/httpbin-gateway.yaml

   Copy to Clipboard Toggle word wrap

4. istio-ingressgateway ルートを取得します。

   INGRESS_HOST=$(oc -n istio-system get routes istio-ingressgateway -o jsonpath='{.spec.host}')

   Copy to Clipboard Toggle word wrap

5. Ingress ゲートウェイから httpbin サービスへの mTLS トラフィックを確認します。

   $ curl -s -I http://$INGRESS_HOST/headers -o /dev/null -w "%{http_code}" -s

   Copy to Clipboard Toggle word wrap