PowerFlex

Configuring PowerFlex CSI Driver with CSM for Authorization

Given a setup where Kubernetes, a storage system, and the CSM for Authorization Proxy Server are deployed, follow these steps to configure the CSI Drivers to work with the Authorization sidecar:

  1. Apply the secret containing the tenant token data into the driver namespace. It’s assumed that the Kubernetes administrator has the token secret manifest, generated by your storage administrator via Generate a Token, saved in /tmp/token.yaml.

     kubectl apply -f /tmp/token.yaml -n vxflexos
    

    This takes the assumption that Powerflex will be installed in the vxflexos namespace.

  2. Edit these parameters in samples/secret/karavi-authorization-config.json file in the CSI PowerFlex driver and update/add connection information for one or more backend storage arrays. In an instance where multiple CSI drivers are configured on the same Kubernetes cluster, the port range in the endpoint parameter must be different for each driver.

    Parameter Description Required Default
    username Username for connecting to the backend storage array. This parameter is ignored. No -
    password Password for connecting to to the backend storage array. This parameter is ignored. No -
    intendedEndpoint HTTPS REST API endpoint of the backend storage array. Yes -
    endpoint HTTPS localhost endpoint that the authorization sidecar will listen on. Yes https://localhost:9400
    systemID System ID of the backend storage array. Yes " "
    skipCertificateValidation A boolean that enables/disables certificate validation of the backend storage array. This parameter is not used. No true
    isDefault A boolean that indicates if the array is the default array. This parameter is not used. No default value from values.yaml

    Create the karavi-authorization-config secret using this command:

    
    kubectl -n vxflexos create secret generic karavi-authorization-config --from-file=config=samples/secret/karavi-authorization-config.json -o yaml --dry-run=client | kubectl apply -f -
    
  3. Create the proxy-server-root-certificate secret.

    If running in insecure mode, create the secret with empty data:

    
    kubectl -n vxflexos create secret generic proxy-server-root-certificate --from-literal=rootCertificate.pem= -o yaml --dry-run=client | kubectl apply -f -
    

    Otherwise, create the proxy-server-root-certificate secret with the appropriate file:

    
    kubectl -n vxflexos create secret generic proxy-server-root-certificate --from-file=rootCertificate.pem=/path/to/rootCA -o yaml --dry-run=client | kubectl apply -f -
    
  4. Prepare the driver configuration secret, applicable to your driver installation method, to communicate with the CSM Authorization sidecar.

    Operator

    Refer to the Create Secret section to prepare secret.yaml to configure the driver to communicate with the CSM Authorization sidecar.

    • Update endpoint to match the localhost endpoint in samples/secret/karavi-authorization-config.json.

    • Update skipCertificateValidation to true.

    • The username and password can be any value since they will be ignored.

    Example:

    - username: "ignored"
      password: "ignored"
      systemID: "ID2"
      endpoint: "https://localhost:9400"
      skipCertificateValidation: true 
      isDefault: true 
      mdm: "10.0.0.3,10.0.0.4"
    
  5. Enable CSM Authorization in the driver installation applicable to your installation method.

    Operator

    Refer to the Install Driver section to edit the parameters in the Custom Resource to enable CSM Authorization.

    Under modules, enable the module named authorization:

    • Update the enabled field to true.

    • Update the image to the image of the CSM Authorization sidecar. In most cases, you can leave the default value.

    • Update the PROXY_HOST environment value to the hostname of the CSM Authorization Proxy Server. csm-authorization.com is a placeholder for the proxyHost. See the administrator of CSM for Authorization for the correct value.

    • Update the SKIP_CERTIFICATE_VALIDATION environment value to true or false depending on if you want to disable or enable certificate validation of the CSM Authorization Proxy Server.

    • Do not update the configVersion. You will notice in the example that it is set to v1.11.0, this ensures that checks on version support do not prevent deployment of the v2.0.0-alpha authorization tech preview.

    Example:

    modules:
      # Authorization: enable csm-authorization for RBAC
      - name: authorization
        # enable: Enable/Disable csm-authorization
        enabled: true
        configVersion: v1.11.0
        components:
        - name: karavi-authorization-proxy
          image: dellemc/csm-authorization-sidecar:v2.0.0-alpha
          envs:
            # proxyHost: hostname of the csm-authorization server
            - name: "PROXY_HOST"
              value: "csm-authorization.com"
    
            # skipCertificateValidation: Enable/Disable certificate validation of the csm-authorization server       
            - name: "SKIP_CERTIFICATE_VALIDATION"
              value: "true"
    
  6. Install the Dell CSI PowerFlex driver following the appropriate documenation for your installation method.