Broker: update unit tests after adding SDP validation

This commit is contained in:
itchyonion 2023-03-22 14:36:39 -07:00
parent 255cee69ed
commit 6c431800b0
No known key found for this signature in database
GPG key ID: 4B87B720348500EA

View file

@ -4,6 +4,7 @@ import (
"bytes" "bytes"
"container/heap" "container/heap"
"encoding/hex" "encoding/hex"
"fmt"
"io" "io"
"io/ioutil" "io/ioutil"
"log" "log"
@ -15,6 +16,7 @@ import (
"time" "time"
"git.torproject.org/pluggable-transports/snowflake.git/v2/common/amp" "git.torproject.org/pluggable-transports/snowflake.git/v2/common/amp"
"git.torproject.org/pluggable-transports/snowflake.git/v2/common/messages"
. "github.com/smartystreets/goconvey/convey" . "github.com/smartystreets/goconvey/convey"
) )
@ -26,6 +28,51 @@ func NullLogger() *log.Logger {
var promOnce sync.Once var promOnce sync.Once
var (
sdp = "v=0\r\n" +
"o=- 123456789 987654321 IN IP4 0.0.0.0\r\n" +
"s=-\r\n" +
"t=0 0\r\n" +
"a=fingerprint:sha-256 12:34\r\n" +
"a=extmap-allow-mixed\r\n" +
"a=group:BUNDLE 0\r\n" +
"m=application 9 UDP/DTLS/SCTP webrtc-datachannel\r\n" +
"c=IN IP4 0.0.0.0\r\n" +
"a=setup:actpass\r\n" +
"a=mid:0\r\n" +
"a=sendrecv\r\n" +
"a=sctp-port:5000\r\n" +
"a=ice-ufrag:CoVEaiFXRGVzshXG\r\n" +
"a=ice-pwd:aOrOZXraTfFKzyeBxIXYYKjSgRVPGhUx\r\n" +
"a=candidate:1000 1 udp 2000 8.8.8.8 3000 typ host\r\n" +
"a=end-of-candidates\r\n"
sid = "ymbcCMto7KHNGYlp"
)
func createClientOffer(sdp, nat, fingerprint string) (*bytes.Reader, error) {
clientRequest := &messages.ClientPollRequest{
Offer: sdp,
NAT: nat,
Fingerprint: fingerprint,
}
encOffer, err := clientRequest.EncodeClientPollRequest()
if err != nil {
return nil, err
}
offer := bytes.NewReader(encOffer)
return offer, nil
}
func createProxyAnswer(sdp, sid string) (*bytes.Reader, error) {
proxyRequest, err := messages.EncodeAnswerRequest(sdp, sid)
if err != nil {
return nil, err
}
answer := bytes.NewReader(proxyRequest)
return answer, nil
}
func decodeAMPArmorToString(r io.Reader) (string, error) { func decodeAMPArmorToString(r io.Reader) (string, error) {
dec, err := amp.NewArmorDecoder(r) dec, err := amp.NewArmorDecoder(r)
if err != nil { if err != nil {
@ -86,11 +133,18 @@ func TestBroker(t *testing.T) {
Convey("Responds to HTTP client offers...", func() { Convey("Responds to HTTP client offers...", func() {
w := httptest.NewRecorder() w := httptest.NewRecorder()
data := bytes.NewReader( data, err := createClientOffer(sdp, NATUnknown, "")
[]byte("1.0\n{\"offer\": \"fake\", \"nat\": \"unknown\"}"))
r, err := http.NewRequest("POST", "snowflake.broker/client", data) r, err := http.NewRequest("POST", "snowflake.broker/client", data)
So(err, ShouldBeNil) So(err, ShouldBeNil)
Convey("with HTTP Bad Request when client offer contains invalid SDP", func() {
data, err = createClientOffer("fake", NATUnknown, "")
invalidRequest, err := http.NewRequest("POST", "snowflake.broker/client", data)
So(err, ShouldBeNil)
clientOffers(i, w, invalidRequest)
So(w.Code, ShouldEqual, http.StatusBadRequest)
})
Convey("with error when no snowflakes are available.", func() { Convey("with error when no snowflakes are available.", func() {
clientOffers(i, w, r) clientOffers(i, w, r)
So(w.Code, ShouldEqual, http.StatusOK) So(w.Code, ShouldEqual, http.StatusOK)
@ -100,16 +154,16 @@ func TestBroker(t *testing.T) {
Convey("with a proxy answer if available.", func() { Convey("with a proxy answer if available.", func() {
done := make(chan bool) done := make(chan bool)
// Prepare a fake proxy to respond with. // Prepare a fake proxy to respond with.
snowflake := ctx.AddSnowflake("fake", "", NATUnrestricted, 0) snowflake := ctx.AddSnowflake("test", "", NATUnrestricted, 0)
go func() { go func() {
clientOffers(i, w, r) clientOffers(i, w, r)
done <- true done <- true
}() }()
offer := <-snowflake.offerChannel offer := <-snowflake.offerChannel
So(offer.sdp, ShouldResemble, []byte("fake")) So(offer.sdp, ShouldResemble, []byte(sdp))
snowflake.answerChannel <- "fake answer" snowflake.answerChannel <- "test answer"
<-done <-done
So(w.Body.String(), ShouldEqual, `{"answer":"fake answer"}`) So(w.Body.String(), ShouldEqual, `{"answer":"test answer"}`)
So(w.Code, ShouldEqual, http.StatusOK) So(w.Code, ShouldEqual, http.StatusOK)
}) })
@ -125,7 +179,7 @@ func TestBroker(t *testing.T) {
done <- true done <- true
}() }()
offer := <-snowflake.offerChannel offer := <-snowflake.offerChannel
So(offer.sdp, ShouldResemble, []byte("fake")) So(offer.sdp, ShouldResemble, []byte(sdp))
<-done <-done
So(w.Code, ShouldEqual, http.StatusOK) So(w.Code, ShouldEqual, http.StatusOK)
So(w.Body.String(), ShouldEqual, `{"error":"timed out waiting for answer!"}`) So(w.Body.String(), ShouldEqual, `{"error":"timed out waiting for answer!"}`)
@ -134,11 +188,20 @@ func TestBroker(t *testing.T) {
Convey("Responds to HTTP legacy client offers...", func() { Convey("Responds to HTTP legacy client offers...", func() {
w := httptest.NewRecorder() w := httptest.NewRecorder()
data := bytes.NewReader([]byte("{test}")) // legacy offer starts with {
r, err := http.NewRequest("POST", "snowflake.broker/client", data) offer := bytes.NewReader([]byte(fmt.Sprintf(`{%v}`, sdp)))
r, err := http.NewRequest("POST", "snowflake.broker/client", offer)
So(err, ShouldBeNil) So(err, ShouldBeNil)
r.Header.Set("Snowflake-NAT-TYPE", "restricted") r.Header.Set("Snowflake-NAT-TYPE", "restricted")
Convey("with HTTP Bad Request when client offer contains invalid SDP", func() {
invalidOffer := bytes.NewReader([]byte("{test}"))
invalidRequest, err := http.NewRequest("POST", "snowflake.broker/client", invalidOffer)
So(err, ShouldBeNil)
clientOffers(i, w, invalidRequest)
So(w.Code, ShouldEqual, http.StatusBadRequest)
})
Convey("with 503 when no snowflakes are available.", func() { Convey("with 503 when no snowflakes are available.", func() {
clientOffers(i, w, r) clientOffers(i, w, r)
So(w.Code, ShouldEqual, http.StatusServiceUnavailable) So(w.Code, ShouldEqual, http.StatusServiceUnavailable)
@ -154,7 +217,7 @@ func TestBroker(t *testing.T) {
done <- true done <- true
}() }()
offer := <-snowflake.offerChannel offer := <-snowflake.offerChannel
So(offer.sdp, ShouldResemble, []byte("{test}")) So(offer.sdp, ShouldResemble, []byte(fmt.Sprintf(`{%v}`, sdp)))
snowflake.answerChannel <- "fake answer" snowflake.answerChannel <- "fake answer"
<-done <-done
So(w.Body.String(), ShouldEqual, "fake answer") So(w.Body.String(), ShouldEqual, "fake answer")
@ -173,7 +236,7 @@ func TestBroker(t *testing.T) {
done <- true done <- true
}() }()
offer := <-snowflake.offerChannel offer := <-snowflake.offerChannel
So(offer.sdp, ShouldResemble, []byte("{test}")) So(offer.sdp, ShouldResemble, []byte(fmt.Sprintf(`{%v}`, sdp)))
<-done <-done
So(w.Code, ShouldEqual, http.StatusGatewayTimeout) So(w.Code, ShouldEqual, http.StatusGatewayTimeout)
}) })
@ -281,9 +344,11 @@ func TestBroker(t *testing.T) {
Convey("Responds to proxy answers...", func() { Convey("Responds to proxy answers...", func() {
done := make(chan bool) done := make(chan bool)
s := ctx.AddSnowflake("test", "", NATUnrestricted, 0) s := ctx.AddSnowflake(sid, "", NATUnrestricted, 0)
w := httptest.NewRecorder() w := httptest.NewRecorder()
data := bytes.NewReader([]byte(`{"Version":"1.0","Sid":"test","Answer":"test"}`))
data, err := createProxyAnswer(sdp, sid)
So(err, ShouldBeNil)
Convey("by passing to the client if valid.", func() { Convey("by passing to the client if valid.", func() {
r, err := http.NewRequest("POST", "snowflake.broker/answer", data) r, err := http.NewRequest("POST", "snowflake.broker/answer", data)
@ -295,11 +360,11 @@ func TestBroker(t *testing.T) {
answer := <-s.answerChannel answer := <-s.answerChannel
<-done <-done
So(w.Code, ShouldEqual, http.StatusOK) So(w.Code, ShouldEqual, http.StatusOK)
So(answer, ShouldResemble, "test") So(answer, ShouldResemble, sdp)
}) })
Convey("with client gone status if the proxy is not recognized", func() { Convey("with client gone status if the proxy ID is not recognized", func() {
data = bytes.NewReader([]byte(`{"Version":"1.0","Sid":"invalid","Answer":"test"}`)) data, err := createProxyAnswer(sdp, "invalid")
r, err := http.NewRequest("POST", "snowflake.broker/answer", data) r, err := http.NewRequest("POST", "snowflake.broker/answer", data)
So(err, ShouldBeNil) So(err, ShouldBeNil)
proxyAnswers(i, w, r) proxyAnswers(i, w, r)
@ -307,7 +372,6 @@ func TestBroker(t *testing.T) {
b, err := ioutil.ReadAll(w.Body) b, err := ioutil.ReadAll(w.Body)
So(err, ShouldBeNil) So(err, ShouldBeNil)
So(b, ShouldResemble, []byte(`{"Status":"client gone"}`)) So(b, ShouldResemble, []byte(`{"Status":"client gone"}`))
}) })
Convey("with error if the proxy gives invalid answer", func() { Convey("with error if the proxy gives invalid answer", func() {
@ -353,7 +417,8 @@ func TestBroker(t *testing.T) {
// Client offer // Client offer
wc := httptest.NewRecorder() wc := httptest.NewRecorder()
datac := bytes.NewReader([]byte("test")) datac, err := createClientOffer(sdp, NATUnknown, "")
So(err, ShouldBeNil)
rc, err := http.NewRequest("POST", "snowflake.broker/client", datac) rc, err := http.NewRequest("POST", "snowflake.broker/client", datac)
So(err, ShouldBeNil) So(err, ShouldBeNil)
@ -367,7 +432,8 @@ func TestBroker(t *testing.T) {
// Proxy answers // Proxy answers
wp = httptest.NewRecorder() wp = httptest.NewRecorder()
datap = bytes.NewReader([]byte(`{"Version":"1.0","Sid":"ymbcCMto7KHNGYlp","Answer":"test"}`)) datap, err = createProxyAnswer(sdp, sid)
So(err, ShouldBeNil)
rp, err = http.NewRequest("POST", "snowflake.broker/answer", datap) rp, err = http.NewRequest("POST", "snowflake.broker/answer", datap)
So(err, ShouldBeNil) So(err, ShouldBeNil)
go func(i *IPC) { go func(i *IPC) {
@ -405,9 +471,9 @@ func TestBroker(t *testing.T) {
So(ctx.idToSnowflake["ymbcCMto7KHNGYlp"], ShouldNotBeNil) So(ctx.idToSnowflake["ymbcCMto7KHNGYlp"], ShouldNotBeNil)
// Client request blocks until proxy answer arrives. // Client request blocks until proxy answer arrives.
dataC := bytes.NewReader(
[]byte("1.0\n{\"offer\": \"fake\", \"nat\": \"unknown\"}"))
wC := httptest.NewRecorder() wC := httptest.NewRecorder()
dataC, err := createClientOffer(sdp, NATUnknown, "")
So(err, ShouldBeNil)
rC, err := http.NewRequest("POST", "snowflake.broker/client", dataC) rC, err := http.NewRequest("POST", "snowflake.broker/client", dataC)
So(err, ShouldBeNil) So(err, ShouldBeNil)
go func() { go func() {
@ -417,11 +483,13 @@ func TestBroker(t *testing.T) {
<-polled <-polled
So(wP.Code, ShouldEqual, http.StatusOK) So(wP.Code, ShouldEqual, http.StatusOK)
So(wP.Body.String(), ShouldResemble, `{"Status":"client match","Offer":"fake","NAT":"unknown","RelayURL":"wss://snowflake.torproject.net/"}`) So(wP.Body.String(), ShouldResemble, fmt.Sprintf(`{"Status":"client match","Offer":%#q,"NAT":"unknown","RelayURL":"wss://snowflake.torproject.net/"}`, sdp))
So(ctx.idToSnowflake["ymbcCMto7KHNGYlp"], ShouldNotBeNil) So(ctx.idToSnowflake[sid], ShouldNotBeNil)
// Follow up with the answer request afterwards // Follow up with the answer request afterwards
wA := httptest.NewRecorder() wA := httptest.NewRecorder()
dataA := bytes.NewReader([]byte(`{"Version":"1.0","Sid":"ymbcCMto7KHNGYlp","Answer":"test"}`)) dataA, err := createProxyAnswer(sdp, sid)
So(err, ShouldBeNil)
rA, err := http.NewRequest("POST", "snowflake.broker/answer", dataA) rA, err := http.NewRequest("POST", "snowflake.broker/answer", dataA)
So(err, ShouldBeNil) So(err, ShouldBeNil)
proxyAnswers(i, wA, rA) proxyAnswers(i, wA, rA)
@ -429,7 +497,7 @@ func TestBroker(t *testing.T) {
<-done <-done
So(wC.Code, ShouldEqual, http.StatusOK) So(wC.Code, ShouldEqual, http.StatusOK)
So(wC.Body.String(), ShouldEqual, `{"answer":"test"}`) So(wC.Body.String(), ShouldEqual, fmt.Sprintf(`{"answer":%#q}`, sdp))
}) })
}) })
} }
@ -566,8 +634,8 @@ func TestMetrics(t *testing.T) {
//Test addition of client failures //Test addition of client failures
Convey("for no proxies available", func() { Convey("for no proxies available", func() {
w := httptest.NewRecorder() w := httptest.NewRecorder()
data := bytes.NewReader( data, err := createClientOffer(sdp, NATUnknown, "")
[]byte("1.0\n{\"offer\": \"fake\", \"nat\": \"unknown\"}")) So(err, ShouldBeNil)
r, err := http.NewRequest("POST", "snowflake.broker/client", data) r, err := http.NewRequest("POST", "snowflake.broker/client", data)
So(err, ShouldBeNil) So(err, ShouldBeNil)
@ -589,8 +657,8 @@ func TestMetrics(t *testing.T) {
//Test addition of client matches //Test addition of client matches
Convey("for client-proxy match", func() { Convey("for client-proxy match", func() {
w := httptest.NewRecorder() w := httptest.NewRecorder()
data := bytes.NewReader( data, err := createClientOffer(sdp, NATUnknown, "")
[]byte("1.0\n{\"offer\": \"fake\", \"nat\": \"unknown\"}")) So(err, ShouldBeNil)
r, err := http.NewRequest("POST", "snowflake.broker/client", data) r, err := http.NewRequest("POST", "snowflake.broker/client", data)
So(err, ShouldBeNil) So(err, ShouldBeNil)
@ -601,7 +669,7 @@ func TestMetrics(t *testing.T) {
done <- true done <- true
}() }()
offer := <-snowflake.offerChannel offer := <-snowflake.offerChannel
So(offer.sdp, ShouldResemble, []byte("fake")) So(offer.sdp, ShouldResemble, []byte(sdp))
snowflake.answerChannel <- "fake answer" snowflake.answerChannel <- "fake answer"
<-done <-done
@ -611,51 +679,57 @@ func TestMetrics(t *testing.T) {
//Test rounding boundary //Test rounding boundary
Convey("binning boundary", func() { Convey("binning boundary", func() {
w := httptest.NewRecorder() w := httptest.NewRecorder()
data := bytes.NewReader( data, err := createClientOffer(sdp, NATRestricted, "")
[]byte("1.0\n{\"offer\": \"fake\", \"nat\": \"restricted\"}")) So(err, ShouldBeNil)
r, err := http.NewRequest("POST", "snowflake.broker/client", data) r, err := http.NewRequest("POST", "snowflake.broker/client", data)
So(err, ShouldBeNil) So(err, ShouldBeNil)
clientOffers(i, w, r)
clientOffers(i, w, r)
w = httptest.NewRecorder() w = httptest.NewRecorder()
data = bytes.NewReader( data, err = createClientOffer(sdp, NATRestricted, "")
[]byte("1.0\n{\"offer\": \"fake\", \"nat\": \"restricted\"}")) So(err, ShouldBeNil)
r, err = http.NewRequest("POST", "snowflake.broker/client", data) r, err = http.NewRequest("POST", "snowflake.broker/client", data)
So(err, ShouldBeNil) So(err, ShouldBeNil)
clientOffers(i, w, r) clientOffers(i, w, r)
w = httptest.NewRecorder() w = httptest.NewRecorder()
data = bytes.NewReader( data, err = createClientOffer(sdp, NATRestricted, "")
[]byte("1.0\n{\"offer\": \"fake\", \"nat\": \"restricted\"}")) So(err, ShouldBeNil)
r, err = http.NewRequest("POST", "snowflake.broker/client", data) r, err = http.NewRequest("POST", "snowflake.broker/client", data)
So(err, ShouldBeNil) So(err, ShouldBeNil)
clientOffers(i, w, r) clientOffers(i, w, r)
w = httptest.NewRecorder() w = httptest.NewRecorder()
data = bytes.NewReader( data, err = createClientOffer(sdp, NATRestricted, "")
[]byte("1.0\n{\"offer\": \"fake\", \"nat\": \"restricted\"}")) So(err, ShouldBeNil)
r, err = http.NewRequest("POST", "snowflake.broker/client", data) r, err = http.NewRequest("POST", "snowflake.broker/client", data)
So(err, ShouldBeNil) So(err, ShouldBeNil)
clientOffers(i, w, r) clientOffers(i, w, r)
w = httptest.NewRecorder() w = httptest.NewRecorder()
data = bytes.NewReader( data, err = createClientOffer(sdp, NATRestricted, "")
[]byte("1.0\n{\"offer\": \"fake\", \"nat\": \"restricted\"}")) So(err, ShouldBeNil)
r, err = http.NewRequest("POST", "snowflake.broker/client", data) r, err = http.NewRequest("POST", "snowflake.broker/client", data)
So(err, ShouldBeNil) So(err, ShouldBeNil)
clientOffers(i, w, r) clientOffers(i, w, r)
w = httptest.NewRecorder() w = httptest.NewRecorder()
data = bytes.NewReader( data, err = createClientOffer(sdp, NATRestricted, "")
[]byte("1.0\n{\"offer\": \"fake\", \"nat\": \"restricted\"}")) So(err, ShouldBeNil)
r, err = http.NewRequest("POST", "snowflake.broker/client", data) r, err = http.NewRequest("POST", "snowflake.broker/client", data)
So(err, ShouldBeNil) So(err, ShouldBeNil)
clientOffers(i, w, r) clientOffers(i, w, r)
w = httptest.NewRecorder() w = httptest.NewRecorder()
data = bytes.NewReader( data, err = createClientOffer(sdp, NATRestricted, "")
[]byte("1.0\n{\"offer\": \"fake\", \"nat\": \"restricted\"}")) So(err, ShouldBeNil)
r, err = http.NewRequest("POST", "snowflake.broker/client", data) r, err = http.NewRequest("POST", "snowflake.broker/client", data)
So(err, ShouldBeNil) So(err, ShouldBeNil)
clientOffers(i, w, r) clientOffers(i, w, r)
w = httptest.NewRecorder() w = httptest.NewRecorder()
data = bytes.NewReader( data, err = createClientOffer(sdp, NATRestricted, "")
[]byte("1.0\n{\"offer\": \"fake\", \"nat\": \"restricted\"}")) So(err, ShouldBeNil)
r, err = http.NewRequest("POST", "snowflake.broker/client", data) r, err = http.NewRequest("POST", "snowflake.broker/client", data)
So(err, ShouldBeNil) So(err, ShouldBeNil)
clientOffers(i, w, r) clientOffers(i, w, r)
@ -664,11 +738,12 @@ func TestMetrics(t *testing.T) {
So(buf.String(), ShouldContainSubstring, "client-denied-count 8\nclient-restricted-denied-count 8\nclient-unrestricted-denied-count 0\n") So(buf.String(), ShouldContainSubstring, "client-denied-count 8\nclient-restricted-denied-count 8\nclient-unrestricted-denied-count 0\n")
w = httptest.NewRecorder() w = httptest.NewRecorder()
data = bytes.NewReader( data, err = createClientOffer(sdp, NATRestricted, "")
[]byte("1.0\n{\"offer\": \"fake\", \"nat\": \"restricted\"}")) So(err, ShouldBeNil)
r, err = http.NewRequest("POST", "snowflake.broker/client", data) r, err = http.NewRequest("POST", "snowflake.broker/client", data)
So(err, ShouldBeNil) So(err, ShouldBeNil)
clientOffers(i, w, r) clientOffers(i, w, r)
buf.Reset() buf.Reset()
ctx.metrics.printMetrics() ctx.metrics.printMetrics()
So(buf.String(), ShouldContainSubstring, "client-denied-count 16\nclient-restricted-denied-count 16\nclient-unrestricted-denied-count 0\n") So(buf.String(), ShouldContainSubstring, "client-denied-count 16\nclient-restricted-denied-count 16\nclient-unrestricted-denied-count 0\n")
@ -743,11 +818,11 @@ func TestMetrics(t *testing.T) {
ctx.metrics.printMetrics() ctx.metrics.printMetrics()
So(buf.String(), ShouldContainSubstring, "snowflake-ips-nat-restricted 1\nsnowflake-ips-nat-unrestricted 1\nsnowflake-ips-nat-unknown 0") So(buf.String(), ShouldContainSubstring, "snowflake-ips-nat-restricted 1\nsnowflake-ips-nat-unrestricted 1\nsnowflake-ips-nat-unknown 0")
}) })
//Test client failures by NAT type
Convey("client failures by NAT type", func() { Convey("client failures by NAT type", func() {
w := httptest.NewRecorder() w := httptest.NewRecorder()
data := bytes.NewReader( data, err := createClientOffer(sdp, NATRestricted, "")
[]byte("1.0\n{\"offer\": \"fake\", \"nat\": \"restricted\"}")) So(err, ShouldBeNil)
r, err := http.NewRequest("POST", "snowflake.broker/client", data) r, err := http.NewRequest("POST", "snowflake.broker/client", data)
So(err, ShouldBeNil) So(err, ShouldBeNil)
@ -759,8 +834,8 @@ func TestMetrics(t *testing.T) {
buf.Reset() buf.Reset()
ctx.metrics.zeroMetrics() ctx.metrics.zeroMetrics()
data = bytes.NewReader( data, err = createClientOffer(sdp, NATUnrestricted, "")
[]byte("1.0\n{\"offer\": \"fake\", \"nat\": \"unrestricted\"}")) So(err, ShouldBeNil)
r, err = http.NewRequest("POST", "snowflake.broker/client", data) r, err = http.NewRequest("POST", "snowflake.broker/client", data)
So(err, ShouldBeNil) So(err, ShouldBeNil)
@ -772,8 +847,8 @@ func TestMetrics(t *testing.T) {
buf.Reset() buf.Reset()
ctx.metrics.zeroMetrics() ctx.metrics.zeroMetrics()
data = bytes.NewReader( data, err = createClientOffer(sdp, NATUnknown, "")
[]byte("1.0\n{\"offer\": \"fake\", \"nat\": \"unknown\"}")) So(err, ShouldBeNil)
r, err = http.NewRequest("POST", "snowflake.broker/client", data) r, err = http.NewRequest("POST", "snowflake.broker/client", data)
So(err, ShouldBeNil) So(err, ShouldBeNil)