github.com/khulnasoft/cli@v0.0.0-20240402070845-01bcad7beefa/docs/reference/commandline/trust_revoke.md (about)

     1  # trust revoke
     2  
     3  <!---MARKER_GEN_START-->
     4  Remove trust for an image
     5  
     6  ### Options
     7  
     8  | Name          | Type | Default | Description                    |
     9  |:--------------|:-----|:--------|:-------------------------------|
    10  | `-y`, `--yes` |      |         | Do not prompt for confirmation |
    11  
    12  
    13  <!---MARKER_GEN_END-->
    14  
    15  ## Description
    16  
    17  `docker trust revoke` removes signatures from tags in signed repositories.
    18  
    19  ## Examples
    20  
    21  ### Revoke signatures from a signed tag
    22  
    23  Here's an example of a repository with two signed tags:
    24  
    25  
    26  ```console
    27  $ docker trust inspect --pretty example/trust-demo
    28  SIGNED TAG          DIGEST                                                              SIGNERS
    29  red                 852cc04935f930a857b630edc4ed6131e91b22073bcc216698842e44f64d2943    alice
    30  blue                f1c38dbaeeb473c36716f6494d803fbfbe9d8a76916f7c0093f227821e378197    alice, bob
    31  
    32  List of signers and their keys for example/trust-demo:
    33  
    34  SIGNER              KEYS
    35  alice               05e87edcaecb
    36  bob                 5600f5ab76a2
    37  
    38  Administrative keys for example/trust-demo:
    39  Repository Key: ecc457614c9fc399da523a5f4e24fe306a0a6ee1cc79a10e4555b3c6ab02f71e
    40  Root Key:       3cb2228f6561e58f46dbc4cda4fcaff9d5ef22e865a94636f82450d1d2234949
    41  ```
    42  
    43  When `alice`, one of the signers, runs `docker trust revoke`:
    44  
    45  ```console
    46  $ docker trust revoke example/trust-demo:red
    47  Enter passphrase for delegation key with ID 27d42a8:
    48  Successfully deleted signature for example/trust-demo:red
    49  ```
    50  
    51  After revocation, the tag is removed from the list of released tags:
    52  
    53  ```console
    54  $ docker trust inspect --pretty example/trust-demo
    55  SIGNED TAG          DIGEST                                                              SIGNERS
    56  blue                f1c38dbaeeb473c36716f6494d803fbfbe9d8a76916f7c0093f227821e378197    alice, bob
    57  
    58  List of signers and their keys for example/trust-demo:
    59  
    60  SIGNER              KEYS
    61  alice               05e87edcaecb
    62  bob                 5600f5ab76a2
    63  
    64  Administrative keys for example/trust-demo:
    65  Repository Key: ecc457614c9fc399da523a5f4e24fe306a0a6ee1cc79a10e4555b3c6ab02f71e
    66  Root Key:       3cb2228f6561e58f46dbc4cda4fcaff9d5ef22e865a94636f82450d1d2234949
    67  ```
    68  
    69  ### Revoke signatures on all tags in a repository
    70  
    71  When no tag is specified, `docker trust` revokes all signatures that you have a signing key for.
    72  
    73  ```console
    74  $ docker trust inspect --pretty example/trust-demo
    75  SIGNED TAG          DIGEST                                                              SIGNERS
    76  red                 852cc04935f930a857b630edc4ed6131e91b22073bcc216698842e44f64d2943    alice
    77  blue                f1c38dbaeeb473c36716f6494d803fbfbe9d8a76916f7c0093f227821e378197    alice, bob
    78  
    79  List of signers and their keys for example/trust-demo:
    80  
    81  SIGNER              KEYS
    82  alice               05e87edcaecb
    83  bob                 5600f5ab76a2
    84  
    85  Administrative keys for example/trust-demo:
    86  Repository Key: ecc457614c9fc399da523a5f4e24fe306a0a6ee1cc79a10e4555b3c6ab02f71e
    87  Root Key:       3cb2228f6561e58f46dbc4cda4fcaff9d5ef22e865a94636f82450d1d2234949
    88  ```
    89  
    90  When `alice`, one of the signers, runs `docker trust revoke`:
    91  
    92  ```console
    93  $ docker trust revoke example/trust-demo
    94  Please confirm you would like to delete all signature data for example/trust-demo? [y/N] y
    95  Enter passphrase for delegation key with ID 27d42a8:
    96  Successfully deleted signature for example/trust-demo
    97  ```
    98  
    99  All tags that have `alice`'s signature on them are removed from the list of released tags:
   100  
   101  ```console
   102  $ docker trust inspect --pretty example/trust-demo
   103  
   104  No signatures for example/trust-demo
   105  
   106  
   107  List of signers and their keys for example/trust-demo:
   108  
   109  SIGNER              KEYS
   110  alice               05e87edcaecb
   111  bob                 5600f5ab76a2
   112  
   113  Administrative keys for example/trust-demo:
   114  Repository Key: ecc457614c9fc399da523a5f4e24fe306a0a6ee1cc79a10e4555b3c6ab02f71e
   115  Root Key:       3cb2228f6561e58f46dbc4cda4fcaff9d5ef22e865a94636f82450d1d2234949
   116  ```
   117