Skip to content

Gestion du certificat X509 pour un site sur PLMshift

Gestion des accès via un Ingress

la ressource Ingress est une ressource standard, il est préférable de l'utiliser.

Un accès via Ingress avec un domaine en .apps.math.cnrs.fr

Les URL disponibles à la demande pour PLMshift en *.apps.math.cnrs.f le sont au titre du développement de votre plateforme. Elles ne sont pas garanties dans le temps. Lorsque votre site sera opérationnel, contactez le support de la PLM afin d'obtenir une URL plus pérenne, et utilisez plutôt la procédure avec LetsEncrypt plus bas.

Créez une ressource du type :

kind: Ingress
apiVersion: networking.k8s.io/v1
metadata:
  name: un_nom_significatif
  annotations:
    route.openshift.io/termination: edge
spec:
  ingressClassName: openshift-default
  rules:
    - host: mon_site.apps.math.cnrs.fr
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: nom_du_service_du_site_web
                port:
                  number: 8080_ou_port_du_service

Un accès via Ingress avec un certificat HTTPS dédié

Vous pouvez profiter des certificats LetsEncrypt pour tout domaine autre que .apps.math.cnrs.fr en suivant les indication suivantes :

  • vous avez la maîtrise du DNS et faites pointer votre site vers le nom plmshift.math.cnrs.fr
  • créez une ressource du type :
kind: Ingress
apiVersion: networking.k8s.io/v1
metadata:
  name: un_nom_significatif
  annotations:
    cert-manager.io/cluster-issuer: letsencrypt
spec:
  ingressClassName: openshift-default
  tls:
    - hosts:
        - mon_site.math.cnrs.fr
      secretName: un_nom_significatif
  rules:
    - host: mon_site.math.cnrs.fr
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: nom_du_service_du_site_web
                port:
                  number: 8080_ou_port_du_service

Gestion des accès via une Route

Les applications sur PLMshift exposent un service web via une route. Seules les routes HTTPS sont routées vers ces routes.

Pour les applications de test, sans visibilité publique recherchée, il est conseillé d'utiliser une URL sous apps.math.cnrs.fr. Cette URL ne doit pas interférer avec d'autres projets. L'URL générée par défaut est https://service-projet.apps.math.cnrs.fr/ Un certificat wildcard TCS est alors utilisé.

Pour utiliser un autre nom DNS, vous pouvez déposer un certificat que vous avez obtenu par un autre biais :

Dépôt d'un certificat maison

Modifier la route pour ajouter les éléments suivants : 

spec:
  tls:
    termination: edge
    certificate: |
      -----BEGIN CERTIFICATE-----
      MIIGSTCCBTGgAwIBAgISBEuuqv1pXB+YbxLW/vHtKZ79MA0GCSqGSIb3DQEBCwUA
      [...]
      XdA+SCOND4YLbhI3WuNcahXCmZ7KpSQflfOKylM=
      -----END CERTIFICATE-----
    key: |
      -----BEGIN RSA PRIVATE KEY-----
      MIIJJwIBAAKCAgEAwDR4j9U3sY3Om/9Gjs/ml6HRD9kkbuFUmGGuMFMKna5vLQ9v
      [...]
      QZxxYSnJoG+8MXN75bQ6ua0MaboKDmVKxE/8fIlnoMUCHzq2ZC5rlMmUzg==
      -----END RSA PRIVATE KEY-----
    insecureEdgeTerminationPolicy: Redirect

Vous pouvez modifier le DNS pour router vers PLMshift avec une décalaration de type A IN 147.210.130.50.