1 /*
2  *  Licensed to the Apache Software Foundation (ASF) under one or more
3  *  contributor license agreements.  See the NOTICE file distributed with
4  *  this work for additional information regarding copyright ownership.
5  *  The ASF licenses this file to You under the Apache License, Version 2.0
6  *  (the "License"); you may not use this file except in compliance with
7  *  the License.  You may obtain a copy of the License at
8  *
9  *      http://www.apache.org/licenses/LICENSE-2.0
10  *
11  *  Unless required by applicable law or agreed to in writing, software
12  *  distributed under the License is distributed on an "AS IS" BASIS,
13  *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14  *  See the License for the specific language governing permissions and
15  *  limitations under the License.
16  */
17 package org.apache.tomcat.util.http;
18
19 import org.apache.tomcat.util.res.StringManager;
20
21 public enum SameSiteCookies {
22
23     /**
24      * Don't set the SameSite cookie attribute.
25      */
26     UNSET("Unset"),
27
28     /**
29      * Cookie is always sent in cross-site requests.
30      */
31     NONE("None"),
32
33     /**
34      * Cookie is only sent on same-site requests and cross-site top level navigation GET requests
35      */
36     LAX("Lax"),
37
38     /**
39      * Prevents the cookie from being sent by the browser in all cross-site requests
40      */
41     STRICT("Strict");
42
43     private static final StringManager sm = StringManager.getManager(SameSiteCookies.class);
44
45     private final String value;
46
47     SameSiteCookies(String value) {
48         this.value = value;
49     }
50
51     public String getValue() {
52         return value;
53     }
54
55     public static SameSiteCookies fromString(String value) {
56         for (SameSiteCookies sameSiteCookies : SameSiteCookies.values()) {
57             if (sameSiteCookies.getValue().equalsIgnoreCase(value)) {
58                 return sameSiteCookies;
59             }
60         }
61
62         throw new IllegalStateException(sm.getString("cookies.invalidSameSiteCookies", value));
63     }
64 }
65