On Tue, 2022-04-05 at 20:31 +0000, Eric Biggers wrote:
> > The IMA policy defines "which" files are to be measured, verified, and/or
> > audited. For those files being verified, the policy rules indicate "how"
> > the file should be verified. For example to require a file be signed,
> > the appraise policy rule must include the 'appraise_type' option.
> >
> > appraise_type:= [imasig] | [imasig|modsig] | [sigv3]
> > where 'imasig' is the original or v2 signature (default),
> > where 'modsig' is an appended signature,
> > where 'sigv3' is the signature v3 format.
> >
> > The policy rule must also indicate the type of signature, if not the IMA
> > default, by specifying the digest type:
> >
> > digest_type:= [verity]
>
> I don't understand the above paragraph. Should it say "type of digest" instead
> of "type of signature"? And what does specifying the digest type do, exactly?
Yes, the "type of digest".
Based on the type of digest, IMA either reads and calculates the file
hash or reads the fs-verity file hash. Based on policy, the hash is
then included in the IMA measurement list, used to verify the file
signature, and/or added to the audit log.
>
> > diff --git a/Documentation/ABI/testing/ima_policy b/Documentation/ABI/testing/ima_policy
> > index 2e0c501ce9c8..acd17183ad8c 100644
> > --- a/Documentation/ABI/testing/ima_policy
> > +++ b/Documentation/ABI/testing/ima_policy
> > @@ -47,7 +47,11 @@ Description:
> > fgroup:= decimal value
> > lsm: are LSM specific
> > option:
> > - appraise_type:= [imasig] [imasig|modsig]
> > + appraise_type:= [imasig] | [imasig|modsig] | [sigv3]
> > + where 'imasig' is the original or v2 signature,
> > + where 'modsig' is an appended signature,
> > + where 'sigv3' is the IMA v3 signature.
> > +
>
> The documentation should explain the differences between the different signature
> types, especially when a user would need to choose one or another.
Agreed, it's confusing. The source of that confusion is a result of
struct signature_v2_hdr name and the field named "version" in the
structure. Here the signature_v2_hdr isn't changing, but a new field
"version" number is defined.
>
> > +
> > + Example of 'measure' and 'appraise' rules requiring fs-verity
> > + signatures (version 3) stored in security.ima xattr.
> > +
> > + The 'measure' rule specifies the 'ima-sigv2' template option,
> > + which includes the indication of type of digest and the file
> > + signature in the measurement list.
> > +
> > + measure func=BPRM_CHECK digest_type=verity \
> > + template=ima-sigv2
>
> This says it requires version 3 signatures, however it then uses "ima-sigv2".
Agreed, it would make more sense to name the template "ima-sigv3" to
refer to the "version" field.
>
> > @@ -183,13 +185,18 @@ enum hash_algo ima_get_hash_algo(const struct evm_ima_xattr_data *xattr_value,
> > return ima_hash_algo;
> >
> > switch (xattr_value->type) {
> > + case IMA_VERITY_DIGSIG:
> > + sig = (typeof(sig))xattr_value;
> > + if (sig->version != 3 || xattr_len <= sizeof(*sig) ||
> > + sig->hash_algo >= HASH_ALGO__LAST)
> > + return ima_hash_algo;
> > + return sig->hash_algo;
>
> It looks like this is falling back to SHA-1 if the xattr is invalid:
>
> int __ro_after_init ima_hash_algo = HASH_ALGO_SHA1;
>
> How about falling back to a more secure hash algorithm, or returning an error?
ima_hash_algo is set to the configured default IMA hash algorithm in
init_ima().
>
> > +/*
> > + * calc_file_id_hash - calculate the hash of the ima_file_id struct data
> > + * @type: xattr type [enum evm_ima_xattr_type]
> > + * @algo: hash algorithm [enum hash_algo]
> > + * @digest: pointer to the digest to be hashed
> > + * @hash: (out) pointer to the hash
> > + *
> > + * IMA signature version 3 disambiguates the data that is signed by
> > + * indirectly signing the hash of the ima_file_id structure data.
> > + *
> > + * Signing the ima_file_id struct is currently only supported for
> > + * IMA_VERITY_DIGSIG type xattrs.
> > + *
> > + * Return 0 on success, error code otherwise.
> > + */
> > +static int calc_file_id_hash(enum evm_ima_xattr_type type,
> > + enum hash_algo algo, const u8 *digest,
> > + struct ima_digest_data *hash)
> > +{
> > + struct ima_file_id file_id = {
> > + .hash_type = IMA_VERITY_DIGSIG, .hash_algorithm = algo};
> > + uint unused = HASH_MAX_DIGESTSIZE - hash_digest_size[algo];
>
> 'uint' is unusual in kernel code; please use 'unsigned int' instead.
Ok
>
> > @@ -1735,14 +1745,24 @@ static int ima_parse_rule(char *rule, struct ima_rule_entry *entry)
> > break;
> > case Opt_appraise_type:
> > ima_log_string(ab, "appraise_type", args[0].from);
> > - if ((strcmp(args[0].from, "imasig")) == 0)
> > + if ((strcmp(args[0].from, "imasig")) == 0) {
> > entry->flags |= IMA_DIGSIG_REQUIRED;
> > - else if (IS_ENABLED(CONFIG_IMA_APPRAISE_MODSIG) &&
> > - strcmp(args[0].from, "imasig|modsig") == 0)
> > + } else if (strcmp(args[0].from, "sigv3") == 0) {
> > + /*
> > + * Only fsverity supports sigv3 for now.
> > + * No need to define a new flag.
> > + */
> > + if (entry->flags & IMA_VERITY_REQUIRED)
> > + entry->flags |= IMA_DIGSIG_REQUIRED;
> > + else
> > + result = -EINVAL;
> > + } else if (IS_ENABLED(CONFIG_IMA_APPRAISE_MODSIG) &&
> > + strcmp(args[0].from, "imasig|modsig") == 0) {
> > entry->flags |= IMA_DIGSIG_REQUIRED |
> > IMA_MODSIG_ALLOWED;
> > - else
> > + } else {
> > result = -EINVAL;
> > + }
>
> This appears to be assuming that the appraise_type option is given after
> digest_type rather than befoore, as digest_type is what sets the
> IMA_VERITY_REQUIRED flag. Is this intentional? Does the order of options
> matter in IMA rules, and if so where are the ordering requirements documented?
>
> Also, it looks like this is allowing appraise_type=imasig or
> appraise_type=imasig|modsig in combination with digest_type=verity. Is that
> intentional? What is the use case for these combinations?
>
All of your comments will be addressed in the next version, including
the ordering issue of "digest_type=verity" and "appraise_type=sigv3".
> > /*
> > - * signature format v2 - for using with asymmetric keys
> > + * signature header format v2 - for using with asymmetric keys
> > + *
> > + * signature format:
> > + * version 2: regular file data hash based signature
> > + * version 3: struct ima_file_id data based signature
> > */
> > struct signature_v2_hdr {
>
> Is this struct also used with version 3, despite having v2 in its name?
> The comment is not clear.
Agreed, it's confusing. Too many versions. This v2 refers to the
header format, while "version" in the signature_v2_hdr refers to the
signature format.
Mimi
