snapshot of https://github.com/grpc/grpc-go.git (master, 2026-09-15; blobs > 131072B omitted)

examples/features/authz/token/token.go

@@ -0,0 +1,55 @@
+/*
+ *
+ * Copyright 2023 gRPC authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+// Package token implements an example of authorization token encoding/decoding
+// that can be used in RPC headers.
+package token
+
+import (
+	"encoding/base64"
+	"encoding/json"
+)
+
+// Token is a mock authorization token sent by the client as part of the RPC headers,
+// and used by the server for authorization against a predefined policy.
+type Token struct {
+	// Secret is used by the server to authenticate the user
+	Secret string `json:"secret"`
+	// Username is used by the server to assign roles in the metadata for authorization
+	Username string `json:"username"`
+}
+
+// Encode returns a base64 encoded version of the JSON representation of token.
+func (t *Token) Encode() (string, error) {
+	barr, err := json.Marshal(t)
+	if err != nil {
+		return "", err
+	}
+	s := base64.StdEncoding.EncodeToString(barr)
+	return s, nil
+}
+
+// Decode updates the internals of Token using the passed in base64
+// encoded version of the JSON representation of token.
+func (t *Token) Decode(s string) error {
+	barr, err := base64.StdEncoding.DecodeString(s)
+	if err != nil {
+		return err
+	}
+	return json.Unmarshal(barr, t)
+}