gitee.com/mirrors_u-root/u-root@v7.0.0+incompatible/pkg/securelaunch/tpm/tpm.go (about)

     1  // Copyright 2019 the u-root Authors. All rights reserved
     2  // Use of this source code is governed by a BSD-style
     3  // license that can be found in the LICENSE file.
     4  
     5  // Package tpm reads and extends pcrs with measurements.
     6  package tpm
     7  
     8  import (
     9  	"bytes"
    10  	"crypto/sha256"
    11  	"encoding/binary"
    12  	"errors"
    13  	"fmt"
    14  	"io"
    15  	"log"
    16  
    17  	"github.com/google/go-tpm/tpm2"
    18  	slaunch "github.com/u-root/u-root/pkg/securelaunch"
    19  	"github.com/u-root/u-root/pkg/securelaunch/eventlog"
    20  	"github.com/u-root/u-root/pkg/tss"
    21  )
    22  
    23  var hashAlgo = tpm2.AlgSHA256
    24  var tpmHandle *tss.TPM
    25  
    26  // marshalPcrEvent writes structure fields piecemeal to buffer.
    27  func marshalPcrEvent(pcr uint32, h []byte, eventDesc []byte) ([]byte, error) {
    28  
    29  	const baseTypeTXT = 0x400                       // TXT specification base event value for DRTM values
    30  	const slaunchType = uint32(baseTypeTXT + 0x102) // Secure Launch event log entry type.
    31  	count := uint32(1)
    32  	eventDescLen := uint32(len(eventDesc))
    33  	slaunch.Debug("marshalPcrEvent: pcr=[%v], slaunchType=[%v], count=[%v], hashAlgo=[%v], eventDesc=[%s], eventDescLen=[%v]",
    34  		pcr, slaunchType, count, hashAlgo, eventDesc, eventDescLen)
    35  
    36  	endianess := binary.LittleEndian
    37  	var buf bytes.Buffer
    38  
    39  	if err := binary.Write(&buf, endianess, pcr); err != nil {
    40  		return nil, err
    41  	}
    42  
    43  	if err := binary.Write(&buf, endianess, slaunchType); err != nil {
    44  		return nil, err
    45  	}
    46  
    47  	if err := binary.Write(&buf, endianess, count); err != nil {
    48  		return nil, err
    49  	}
    50  
    51  	for i := uint32(0); i < count; i++ {
    52  		if err := binary.Write(&buf, endianess, hashAlgo); err != nil {
    53  			return nil, err
    54  		}
    55  
    56  		if err := binary.Write(&buf, endianess, h); err != nil {
    57  			return nil, err
    58  		}
    59  	}
    60  
    61  	if err := binary.Write(&buf, endianess, eventDescLen); err != nil {
    62  		return nil, err
    63  	}
    64  
    65  	if err := binary.Write(&buf, endianess, eventDesc); err != nil {
    66  		return nil, err
    67  	}
    68  	return buf.Bytes(), nil
    69  }
    70  
    71  // sendEventToSysfs marshals measurement events and writes them to sysfs.
    72  func sendEventToSysfs(pcr uint32, h []byte, eventDesc []byte) {
    73  
    74  	b, err := marshalPcrEvent(pcr, h, eventDesc)
    75  	if err != nil {
    76  		log.Println(err)
    77  	}
    78  
    79  	if e := eventlog.Add(b); e != nil {
    80  		log.Println(e)
    81  	}
    82  }
    83  
    84  /*
    85   * hashReader calculates the sha256 sum of an io reader.
    86   */
    87  func hashReader(f io.Reader) []byte {
    88  
    89  	h := sha256.New()
    90  	if _, err := io.Copy(h, f); err != nil {
    91  		log.Fatal(err)
    92  	}
    93  
    94  	return h.Sum(nil)
    95  }
    96  
    97  /*
    98   * New sets up a tpm device handle
    99   * that can be used for storing hashes.
   100   */
   101  func New() error {
   102  	tpm, err := tss.NewTPM()
   103  	if err != nil {
   104  		return fmt.Errorf("couldn't talk to TPM Device: err=%v", err)
   105  	}
   106  
   107  	tpmHandle = tpm
   108  	return nil
   109  }
   110  
   111  /*
   112   * Close ends connection to a tpm device handle
   113   */
   114  func Close() {
   115  	if tpmHandle != nil {
   116  		tpmHandle.Close()
   117  		tpmHandle = nil
   118  	}
   119  }
   120  
   121  /*
   122   * readPCR reads pcr#x, where x is provided by 'pcr' arg and returns
   123   * the result in a byte slice.
   124   * 'tpmHandle' is the tpm device that owns the 'pcr'.
   125   * err is returned if read fails.
   126   */
   127  func readPCR(pcr uint32) ([]byte, error) {
   128  	if tpmHandle == nil {
   129  		return nil, errors.New("tpmHandle is nil")
   130  	}
   131  
   132  	val, err := tpmHandle.ReadPCR(pcr)
   133  	if err != nil {
   134  		return nil, fmt.Errorf("can't read PCR %d, err= %v", pcr, err)
   135  	}
   136  	return val, nil
   137  }
   138  
   139  /*
   140   * extendPCR writes the measurements passed as 'hash' arg to pcr#x,
   141   * where x is provided by 'pcr' arg.
   142   *
   143   * pcr is owned by 'tpm2Handle', a tpm device handle.
   144   * err is returned if write to pcr fails.
   145   */
   146  func extendPCR(pcr uint32, hash []byte) error {
   147  	if tpmHandle == nil {
   148  		return errors.New("tpmHandle is nil")
   149  	}
   150  
   151  	return tpmHandle.Extend(hash, pcr)
   152  }
   153  
   154  /*
   155   * ExtendPCRDebug extends a PCR with the contents of a byte slice
   156   * and notifies the kernel of this measurement by sending event via sysfs.
   157   *
   158   * In debug mode, it prints
   159   * 1. old pcr value before the hash is written to pcr
   160   * 2. new pcr values after hash is written to pcr
   161   * 3. compares old and new pcr values and prints error if they are not
   162   */
   163  func ExtendPCRDebug(pcr uint32, data io.Reader, eventDesc string) error {
   164  	oldPCRValue, err := readPCR(pcr)
   165  	if err != nil {
   166  		return fmt.Errorf("readPCR failed, err=%v", err)
   167  	}
   168  	slaunch.Debug("ExtendPCRDebug: oldPCRValue = [%x]", oldPCRValue)
   169  
   170  	hash := hashReader(data)
   171  
   172  	slaunch.Debug("Adding hash=[%x] to PCR #%d", hash, pcr)
   173  	if e := extendPCR(pcr, hash); e != nil {
   174  		return fmt.Errorf("can't extend PCR %d, err=%v", pcr, e)
   175  	}
   176  	slaunch.Debug(eventDesc)
   177  
   178  	// send event if PCR was successfully extended above.
   179  	sendEventToSysfs(pcr, hash, []byte(eventDesc))
   180  
   181  	newPCRValue, err := readPCR(pcr)
   182  	if err != nil {
   183  		return fmt.Errorf("readPCR failed, err=%v", err)
   184  	}
   185  	slaunch.Debug("ExtendPCRDebug: newPCRValue = [%x]", newPCRValue)
   186  
   187  	finalPCR := hashReader(bytes.NewReader(append(oldPCRValue, hash...)))
   188  	if !bytes.Equal(finalPCR, newPCRValue) {
   189  		return fmt.Errorf("PCRs not equal, got %x, want %x", finalPCR, newPCRValue)
   190  	}
   191  
   192  	return nil
   193  }